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Notices 


Any reference to an IBM licensed program is not intended to state or imply that only 
IBM’s licensed program may be used. Any functionally equivalent product, program, 
or service that does not infringe any of IBM’s intellectual property rights can be used 
instead of the IBM product, program, or service. Evaluation and verification of 
operation in conjunction with other products, programs, or services, except those 
expressly designated by IBM, is the user’s responsibility. 

IBM might have patents or pending patent applications covering subject matter in this 
document. The furnishing of this document does not give you any license to these 
patents. You can send license inquiries, in writing, to: 

IBM Director of Licensing 
IBM Corporation 
500 Columbus Avenue 
Thornwood, NY 10594 USA 

This publication contains examples of data and reports used in daily business 
operations. To illustrate them as completely as possible, the examples include the 
names of individuals, companies, brands, and products. All of these names are 
fictitious and any similarity to the names and addresses used by an actual business 
enterprise is entirely coincidental. 


Trademarks 

The following terms are trademarks or service marks of the IBM Corporation in the 
United States or other countries: 


BookManager 
Common User Access 
CUA 
IBM 

IBMLink 
Library Reader 
Open Class 
OS/2 

Presentation Manager 
PROFS 
VisualAge 
Workplace Shell 


© Copyright IBM Corp. 1995 


xxiii 



xxiv 


The following terms are trademarks of other companies: 

C++ American Telephone & Telegraph Company 


Visual Builder Parts Reference 



About this Book 

Welcome to the Visual Builder Parts Reference. This book provides information 
about parts and classes you can use to build applications. It describes parts you can 
work with on the free-form surface in the Composition Editor. 


Who Should Use This Book 

Programmers who want to develop C++ applications using Visual Builder should read 
this book. It is written primarily for the programmer building applications from 
Visual Builder parts using the Composition Editor. 


How to Use This Book 

Use this book to find detailed information about Visual Builder parts. 

Visual Builder concepts 

If you are not familiar with parts, features, and connections, read “Basic Concepts” on 
page 1. 

Part chapters 

Part chapters are organized alphabetically in two sections: 

“Visual and Nonvisual Parts” on page 7 

All visual and nonvisual parts and any class interface parts on the parts palette. 

“Class Interface Parts” on page 509 

All class interface parts except those on the parts palette. 

If you want to use a part you are not familiar with, read the part description first. 
Then, read the part building guidelines to learn how to use the part in your own 
composite part. 

You can review the topics on attributes, actions, and events for information on part 
features. Part feature tables contain information about implementation, such as data 
types, parameter lists, and event information. These tables contain all attributes, 
actions, or events of the part, including those inherited from other parts. Locally 
defined feature names are emphasized for identification. 

You can find settings information in the topics for part settings pages. 
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See “How to Use Part Information” on page xxvi for details on the information 
available in a part chapter. 

Class information 

If you need more information on the class that supports a part or on a class member 
that implements a feature, refer to the IBM Open Class Library Reference. 

Appendixes 

The appendixes provide master tables of all part attributes, actions, and events. These 
tables are essentially the same as feature tables for individual parts. The master 
feature tables differ from the part feature tables in the following ways: 

• They contain attributes, actions, or events for all parts. 

• They identify the class that supports the part feature. 

• Because of the global context, they do not identify locally defined features. 

Highlighting conventions 

Key terms are emphasized as follows: 

• When a conceptual term is introduced and defined, it appears in italics. 

• User interface elements appear in bold type. 

• Part features (attributes, actions, and events) appear in italics. 

• Code segments appear in a Courier font. 


How to Use Part Information 

Part chapters cover the following topics: 

• “Part Description” on page xxvii 

• “Building Guidelines” on page xxvii 

• “Attributes” on page xxviii 

• “Actions” on page xxviii 

• “Events” on page xxix 

• “Settings” on page xxix 

Some of these topics do not apply to all parts. Most parts have attributes and actions, 
but some do not have events. Class interface parts do not support notification and, 
therefore, have no events. Generally, class interface parts do not have settings 
defined. Part building guidelines are provided for fully enabled parts and for class 
interface parts on the parts palette, but they are not provided for other class interface 
parts. 
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Part Description 

The part description topic provides model, graphic, and text descriptions of the part. 

Model description 


The following part model information is provided: 


Title 


Class name 


Base part 


The part title appears in the status area of the Composition 
Editor when the part is selected on the parts palette. 

Identifies the class supporting the part. If you need more 
information on the class, refer to the IBM Open Class Library 
Reference. 

Identifies the parent part. 


Part type 


Identifies the part as a class interface, nonvisual, or visual part. 


Part file Identifies the data file containing the part definition. You load 

this data file into the Composition Editor to use the part. 


Graphic description 


For fully enabled parts and for class interface parts on the parts palette, a graphic 
representation of the part as it appears on the free-form surface is included. 

Text description 

The text description of the part covers the following points: 

• What the part is 

• What the user can do with the part 

• What to use the part for in your applications 

Building Guidelines 

The building guidelines give you information about using Visual Builder part settings 
and features for some common tasks related to building composite parts. The 
guidelines describe the use of many attributes, actions, events, and settings in support 
of these tasks. 


These guidelines are intended to be representative rather than comprehensive. They 
focus on common building tasks particularly applicable to each part. You can 
generally perform many tasks when building with a Visual Builder part that are not 
described for the part. For example, enabling and disabling actions are common to 
controls in general but are described only for buttons, check boxes, and menu items. 
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Attributes 

The attributes section contains a table of all attributes of the part. The table includes 
attributes inherited by the part from its parent hierarchy. The attributes are listed in 
alphabetical order. 

The Attribute column gives the name of each attribute. The attribute name is also the 
name of the get member function for the attribute. The get member function retrieves 
the attribute value. The names of attributes defined in this part are emphasized as 
follows: localAttribute. 

The S 1 column indicates whether the attribute can be set. If the attribute can be set, a 
■ appears in the S column. This means that you can add a connection in the 
Composition Editor to set the value. A set member function assigns the attribute 
value. 

The E 2 column indicates whether the attribute supports connections that provide the 
new attribute value when the value changes. If the attribute supports these 
connections, a ■ appears in the E column. This means that you can add a connection 
in the Composition Editor to get the new value when the value changes. When the 
attribute value changes, an attribute-change event is sent. A notification ID identifies 
the attribute-change event. 

The Data type column gives the data type of each attribute. 

Visual Builder provides attribute implementation information, including member 
function signatures, in the Composition Editor. To view this information, open the 
part contextual menu by clicking mouse button 2 on the part. Then, select the 
Browse Part Features choice on the menu. 


Actions 

The actions section contains a table of all actions of the part. The table includes 
actions inherited by the part from its parent hierarchy. The actions are listed in 
alphabetical order. 

The Action column gives the name of each action. The action name is also the name 
of the action member function. The action member function performs the action. The 
names of actions defined in this part are emphasized as follows: localAction. 

The Parameters column shows parameters for the action. The type, name, and any 
default value is shown for each parameter as they appear in the class .hpp file. The 


1 The S column heading represents Set. 

2 The E column heading represents Event. 
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name is presented in italics, for example, parmName. If the parameter has a default 
value, indicated by =val ue after the parameter name, you do not need to provide a 
parameter value unless you want a different value. 

Visual Builder provides action implementation information, including member 
function signatures, in the Composition Editor. To view this information, open the 
part contextual menu by clicking mouse button 2 on the part. Then, select the 
Browse Part Features choice on the menu. 


Events 

The events section contains a table of all events of the part. The table includes 
events inherited by the part from its parent hierarchy. The events are listed in 
alphabetical order. 

The Event column gives the name of each event. The names of events defined in this 
part are emphasized as follows: localEvent. 

The Notification ID column shows the notification ID that identifies the event. 
Notification IDs provided by the class appear in mixed case. Notification IDs 
implemented by Visual Builder appear in upper case. 

Visual Builder provides event implementation information, including any parameters, 
in the Composition Editor. To view this information, open the part contextual menu 
by clicking mouse button 2 on the part. Then, select the Browse Part Features choice 
on the menu. 


Settings 

Part settings information describes the settings on each of the following settings pages 
defined for the part: 

• General 

• Control 

• Styles 

• Handlers 

• Color 

• Size/Position 

• Font 

Settings pages are presented in their order of appearance in the settings notebook. 

Some parts have only a single part settings page, named as the part type. These 
settings pages are not described. 

The settings for each settings page are presented in the order of their appearance on 
the page. Each setting is briefly described and its default value, if any, is indicated. 
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What Parts Are Here? 

This book covers parts from the following part data files: 

• vbbase.vbb 

• vbmm.vbb 

This book does not discuss abstract parts unless they are implemented by Visual 
Builder and presented on the parts palette. A few concrete parts used by Visual 
Builder are also omitted. You should not use these parts: 

• IFlyText 

• IMenuBar 

• INotebook::PageSettings 

• IPopUpMenu 

• IStandardNotifier 

• ISubmenu 

• IVBMinSize 

• IVBTitle 

A few parts are provided as handlers that you can specify on the Handlers settings 
page of various parts. You should not use these handler parts in any other way: 

• IVBCheckMenuHandler 

• IVBDragDropHandler 

• IVBMinSizeViewPortHandler 

• IVBPopupMenuHandler 


How to Get Help 

There are three kinds of online information available to you while you are using 

VisualAge C++: 

Online documents 

These are complete documents, like the one you are reading now, 
presented online. These documents contain detailed information on the 
different aspects of VisualAge C++. For your convenience, the online 
documents are presented in two formats: 

• Standard format. See “Getting Flelp Inside VisualAge C++” on 
page xxxi for instructions on opening standard format documents 
from inside VisualAge C++. See “Getting Help from the Command 
Line” on page xxxii for instructions on opening standard format 
documents from the command line. The following documents are 
available in standard format: 

- Read Me First! 


XXX 
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- Welcome to VisualAge C++ 

- User's Guide and Reference 

- Programming Guide 

- Visual Builder User's Guide 

- Visual Builder Parts Reference 

- Building VisualAge C++ Parts for Fun and Profit 

- Class Library User's Guide 

- Class Library Reference 

- IBM Dictionary of Computing 

- C Library Reference 

- Editor Command Reference 

• BookManager format. See “BookManager Books” on page xxxii for 
details on how to access online documents in this format. For a list 
of the VisualAge C++ documents that are available in BookManager 
format, see “The VisualAge C++ BookManager Library” on 
page 651. 

Contextual help 

Contextual help is available throughout VisualAge C++. This help tells 
you all about the elements that you see in the interface, including menus, 
entry fields, and pushbuttons. 

How Do I help 

Many of the common tasks that you want to perform with 
VisualAge C++ are described in How Do I help. The How Do I help for 
a task gives you step-by-step instructions for completing the task. There 
is overall How Do I help for VisualAge C++, as well as individual task 
lists for each of its components. 

Getting Help Inside VisualAge C++ 

All three kinds of help are available directly within the VisualAge C++ interface: 

• To get general contextual help for the component of VisualAge C++ that you are 
using, press FI anywhere in the window. 

• To get contextual help on a particular menu, menu item, or button, highlight the 
element and press FI. 

• To get access to all of the help information that is available to you in a particular 
window, click on Hel p in the menu bar at the top of the window. This menu 
includes the following selections: 

- Hel p Index, an alphabetical list of all of the help topics that are available 
from this window 

- General Hel p, overall help for the window 
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- Using Help, general information about the help facility 

- How Do I. the How Do I help for the component 

- Product Information, a dialog that shows the level of VisualAge C++ 
being used 

• To get detailed information, open the Information folder in the VisualAge C++ 
folder. In this folder you will find icons for a variety of online documents that 
describe, in detail, the different aspects of VisualAge C++. To open a particular 
online document, double click on its icon. 

Getting Help from the Command Line 

If you want, you can look at the online documents by issuing the view command. 

The installation routine stores the online document files in the \ I BMCPP\HELP directory. 
To view the IBM Dictionary of Computing, for example, make C:\IBMCPP\HELP your 
current directory (substituting the drive where you installed VisualAge C++ for C:) 
and enter the following command: 

VIEW CPPLNG.INF 

If you want to get information on a specific topic, you can specify a word or a series 
of words after the file name. If the words appear in an entry in the table of contents 
or the index, the online document is opened to the associated section. For example, if 
you want to read the section on operator precedence in the IBM Dictionary of 
Computing, you can enter the following command: 

VIEW CPPLNG.INF OPERATOR PRECEDENCE 

BookManager Books 

In addition to standard format, the online documents are also available in 
BookManager format. In this format they can be read using the BookManager 
READ/2 product (program number 73F6023). VisualAge C++ comes complete with 
the IBM Library Reader, which allows you to read BookManager books without 
having to install the complete BookManager READ/2 product. Like the standard 
format, the BookManager format features hypertext links and a search utility. 
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Parti. Basic Concepts 

The following chapters introduce concepts related to the part interface and the 
notification framework. 

Chapter 1. The Part Interface . 3 

Features . 3 

Connections . 3 

Chapter 2. The Notification Framework . 5 

Events, Notifiers, and Observers . 5 

Attribute Notifications . 5 

Event Notifications . 5 
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Chapter 1. The Part Interface 

Visual Builder packages classes as parts. The part interface gives you the means to 
work visually with classes through standard features and connections. Fully enabled 
parts can notify each other of value or state changes that occur in them. Class 
interface parts provide limited features and support connections but cannot send 
notifications. 

For information on implementing parts and features, refer to Building VisualAge C++ 
Parts for Fun and Profit. 


Features 

Part interface features organize class members as elements of attributes, actions, and 
events. These features have the following characteristics: 

• An attribute is a property of a part. Class member functions enable you to get 
and set the property. Most attributes can be set as well as queried. Many 
attributes also have notification IDs that are used to report attribute changes. 

• An action is a behavior of a part. A class member function performs the part 
behavior. 

• An event informs other parts of an occurrence in a part. A notification ID 
identifies the event. 


Connections 

Part connections give you the ability to visually relate part features in the following 
ways: 

• An attribute-to-action connection maps an attribute to an action. When the 
attribute value is changed, the action is performed. 

• An attribute-to-attribute connection maps an attribute to another attribute. When 
the source attribute value is changed, the other attribute is updated with the same 
value. 

• An event-to-action connection maps an event to an action. When the event 
occurs, the action is performed. 

• An event-to-attribute connection maps an event to an attribute. When the event 
occurs, the attribute is updated with a new value. 

• An event-to-member-function connection maps an event to a class member 
function. When the event occurs, the member function is called. 
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• A parameter connection maps a value to a parameter on another connection. The 
parameter connection can be made between the parameter and any of the 
following: 

- an attribute 

- an action 

- a member function 

- custom logic 

For more information on connections, refer to the Visual Builder User’s Guide. 

“The Notification Framework” on page 5 describes class support for these 
connections. 
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Chapter 2. The Notification Framework 

The notification framework supports communication among parts for attribute changes 
and other events. This communication enables visual connections in the Composition 
Editor. 

As a visual application builder, you need not be concerned with implementation 
details of the notification framework. Visual Builder provides this support for visual 
connections. Be aware, however, that you can make connections only from attributes 
with notification IDs and from events. All part interface events have notification IDs. 

For more information on implementing notifications, refer to Building VisualAge C++ 
Parts for Fun and Profit. 


Events, Notifiers, and Observers 

In this section, “event” is used in the general sense. It represents either an 
attribute-change event or an event feature of the part interface. 

A part in which an event occurs can notify other parts about the event. The reporting 
part is called the notifier. Each part to be notified of an event is registered as an 
observer of the event. The addObserver action performs this function. 

The notifier informs observers of an event by using the notifyObservers action. A 
notification ID identifies the event, and notification data, if any, provides additional 
information. 

A notifier can enable and disable notification of observers. The enableNotification 
action turns on notification for a part, and disableNotification turns it off. 


Attribute Notifications 

Notifications are commonly used to inform observers when an attribute value 
changes. A notifier sends this notification when an attribute is changed and the 
attribute has a notification ID. The notifier sends the new attribute value as 
notification data. 


Event Notifications 

Notifications are used to inform observers when an event defined by the part interface 
occurs. The notifier can send information about some events as notification data. 
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Part 2. Visual and Nonvisual Parts 


The following chapters provide information on visual and nonvisual parts, which are 
fully enabled parts. Chapters on class interface parts on the parts palette also appear 


in this section. 

Chapter 3. IAnimatedButton . 11 

Chapter 4. IBitmapControl . 23 

Chapter 5. ICanvas . 33 

Chapter 6. ICheckBox . 43 

Chapter 7. ICircularSlider . 53 

Chapter 8. ICollectionViewComboBox . 63 

Chapter 9. ICollectionViewListBox . 77 

Chapter 10. IComboBox . 89 

Chapter 11. IContainerColumn . 103 

Chapter 12. ICustomButton . 109 

Chapter 13. IEntryField . 119 

Chapter 14. IFrameWindow . 131 

Chapter 15. IGraphicPushButton . 145 

Chapter 16. IGroupBox . 155 

Chapter 17. IHelpWindow . 165 

Chapter 18. IlconControl . 171 

Chapter 19. IlnfoArea . 181 

Chapter 20. IListBox . 189 


© Copyright IBM Corp. 1995 


7 





















Chapter 21. IMenu . 201 

Chapter 22. IMenuCascade . 209 

Chapter 23. IMenuItem . 213 

Chapter 24. IMenuSeparator . 219 

Chapter 25. IMessageBox . 221 

Chapter 26. IMMAmpMixer . 225 

Chapter 27. IMMAudioCD . 229 

Chapter 28. IMMCDXA 235 

Chapter 29. IMMDigitalVideo . 241 

Chapter 30. IMMMasterAudio . 247 

Chapter 31. IMMPlayerPanel . 251 

Chapter 32. IMMSequencer . 259 

Chapter 33. IMMWaveAudio . 263 

Chapter 34. IMultiCellCanvas . 269 

Chapter 35. IMultiLineEdit . 281 

Chapter 36. INotebook . 293 

Chapter 37. INumericSpinButton . 305 

Chapter 38. IOutlineBox . 315 

Chapter 39. IProgressIndicator . 325 

Chapter 40. IPushButton . 337 

Chapter 41. IRadioButton . 347 

Chapter 42. IScrollBar . 357 
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Chapter 43. ISetCanvas . 369 

Chapter 44. ISlider . 381 

Chapter 45. ISplitCanvas . 393 

Chapter 46. IStaticText . 403 

Chapter 47. ITextSpinButton . 413 

Chapter 48. ITitle 423 

Chapter 49. IToolBar . 429 

Chapter 50. IToolBarButton . 439 

Chapter 51. IVBContainerControl . 451 

Chapter 52. IVBFactory . 467 

Chapter 53. IVBFileDialog . 469 

Chapter 54. IVBFlyText 473 

Chapter 55. IVBFontDialog . 479 

Chapter 56. IVBNotebookPage . 483 

Chapter 57. IV BV ariableClass 487 

Chapter 58. IVBVariableClassPointer . 489 

Chapter 59. IVBVariablePart . 491 

Chapter 60. IVBVariablePartPointer . 493 

Chapter 61. IViewPort . 495 

Chapter 62. IVSequence . 505 
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Chapter 3. lAnimatedButton 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM animated button control 

lAnimatedButton 

ICustomButton 

Visual part 

vbbase.vbb 



An lAnimatedButton part is a selection button for an action. The choice is identified 
by a graphic on the animated button. 

The user can click the animated button to perform the indicated function. When the 
action is selected, the graphic on the button is replaced by a cyclic series of graphics. 
This gives the appearance of animation on the button while the requested action is 
performed. 

Use an lAnimatedButton part to give the user an action choice that shows action 
when it is selected. A multimedia play button with a disk that spins when pressed is 
an example of an animated button. 


Building Guidelines - lAnimatedButton 

When building with an lAnimatedButton part, you can do the following: 

• Assign animation bitmaps to the animated button. Do this by setting the Bitmap 
field on the lAnimatedButton General settings page. You can either select a 
bitmap identifier, such as the play identifier, or specify a resource range to set the 

Bitmap field. 

• Set the animation rate for the graphic sequence on the button. Do this by setting 
the Animation rate field on the lAnimatedButton General settings page. 

• Give the button the appearance of remaining latched down while it is active. 

This simulates the behavior of such controls as a play button. Do this by setting 
the latchable field on the lAnimatedButton Styles settings page. 

• Allow the user to reach the button by using a tab key. Do this by setting the 
tabStop field to On on the lAnimatedButton Styles settings page. 

• If the button is the first control in a group, allow the user to use cursor keys to 
move between the button and follow controls in the group. Do this by setting the 
group field to On on the lAnimatedButton Styles settings page. 
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• Start the action represented by the button. Do this by connecting the 
lAnimatedButton buttonClickEvent feature to the action on the target part. For 
example, to start the play action of an IMMAudioCD, connect the 
lAnimatedButton buttonClickEvent feature to the IMMAudioCD play action. 

• Enable or disable the animated button when an event occurs. 

Enable the button as follows: 

1. Connect the event to the lAnimatedButton enable action. 

2. The button is enabled by default. If you have changed this default, open 
settings for the connection, press the Set parameters push button, and check 
the Enabled setting. 

Disable the button by connecting the event to the lAnimatedButton disable 
action. 


Attributes - lAnimatedButton 


Figure 1 (Page 1 of 2). Attributes 

lAnimatedButton. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

allowsMouseClickFocus 

■ 


Boolean 

animatedWhenLatched 



Boolean 

animationRate 

■ 


unsigned long 

animationStarted 



Boolean 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

autoLatchEnabled 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

bitmap 



IBitmapHandle 

bitmapCount 



unsigned long 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

currentBitmapIndex 



unsigned long 

defaultPushButton 



I Windo wHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 
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Actions 


Figure 1 (Page 2 of 2). Attributes - IAnimatedButton. (S is Set, E is Event) 


Attribute 

S 

E 

Data type 

highlighted 



Boolean 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

latched 

■ 

■ 

Boolean 

latchedBackgroundColor 

■ 


IColor 

latchedBackgroundColorHalftone 



Boolean 

latchedForegroundColor 

■ 


IColor 

latchingEnabled 

■ 


Boolean 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

userData 

■ 


unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 

ii mated Button 




Figure 2 (Page 1 of 3). Actions 

IAnimatedButton 



Action 

Parameters 



apply B idi S ettings 


capturePointer 

click 

con vertT oGUIS ty le 


BidiSettings& settings 
Boolean childlnherit=tme 
Boolean refresh^ true 
Boolean capture=tme 

IBitFlag& style 

Boolean extendedOnly= false 
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Figure 2 (Page 2 of 3). Actions - IAnimatedButton 

Action Parameters 


disable 

disableAnimateWhenLatched 

disableAutoLatch 

disableGroup 

disableLatching 

disableMouseClickFocus 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableAnimateWhenLatched 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

highlight 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteBackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetLatchedBackgroundColor 

resetLatchedForegroundColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setBitmaps 

setFocus 


IEvent& event 
Boolean callDefProc=lruQ 
Boolean enabled= true 
Boolean enable= true 
Boolean enableWindow=tmG 
IException& dispatcherException 
IEvent& exceptionEvent 

Boolean highlight= true 
unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IResourceId& firstBitmap 
unsigned long count 
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Figure 2 (Page 3 of 3). Actions - IAnimatedButton 


Action 

Parameters 

setLayoutDistorted 

unsigned long layoutAttributesOn 


unsigned long layoutAttributesOff 

show 

Boolean visible=tme 

showSourceEmphasis 

Boolean show= true 

startAnimation 

unsigned long index= 0 

stopAnimation 


unhighlight 


unlatch 


limatedButton 


Figure 3. Events - IAnimatedButton 


Event 

Notification ID 

buttonClickEvent 

buttonClickld 

commandEvent 

commandld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCU SFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 


General Settings - IAnimatedButton 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

Latched 

Sets the part to the latched state. 

Default value: Not selected 
Animation rate 

Sets the current animation rate for the part. 

Default value: 1,000 
Bitmap 

Specifies the bitmap to be used. 

Default value: Identifier 
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Identifier list 

Sets a list of identifers for the part. 

Default value: The first item in the list is selected by default. 

DLL name 

Specifies the name of the resource .dll that contains the bitmap. 

Default value: None 
Resource ID 

Specifies the resource identifier of the bitmap. 

Default value: None 
Bitmap count 

Specifies the number of bitmaps to be used. 

Default value: 1 


Control Settings - lAnimatedButton 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 
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Styles Settings - lAnimatedButton 

defaultStyle() 

Resets the part to the original default style. 

Default value: Selected 

animate WhenLatched 

Sets the style for the part to the latched state. 

Default value: Not selected 
latchable 

Sets the default style to the latchable state. 

Default value: The Default radio button is selected. 

autoLatch 

Sets the default style for the part the automatic latch state. 

Default value: The Default radio button is selected. 

noPointerFocus 

Allows the cursor stay on a control for which information is required, rather than 
moving to the button. Buttons with this style do not set the focus to themselves 
when the user clicks on them using the mouse. This has no effect on keyboard 
interaction. 

Default value: The Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 
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clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - lAnimatedButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 
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Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - lAnimatedButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Latched foreground 

Sets the foreground color for latched text 

Latched background 

Sets the background color for latched text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 
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RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - lAnimatedButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - lAnimatedButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 4. IBitmapControl 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM bitmap control 
IBitmapControl 
IStaticText 
Visual part 
vbbase.vbb 



♦flttt 



An IBitmapControl part draws a graphical image on the background of another part. 
The user does not use the bitmap for any action. 

Use an IBitmapControl part to provide a picture for graphical application data. Be 
aware that a bitmap is resized on either a set canvas or a multicell canvas when the 
canvas is resized. 


Building Guidelines - IBitmapControl 

When building with an IBitmapControl part, you can do the following: 

• Assign a bitmap to the control. Do this by setting the DLL name and Resource 
ID fields on the IBitmapControl General settings page. 

• Show or hide the bitmap when an event occurs. 

Show the bitmap as follows: 

1. Connect the event to the IBitmapControl show action. 

2. Open settings for the connection, press the Set parameters push button, and 
check the visible setting. 

Hide the bitmap by connecting the event to the IBitmapControl disable action. 
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Attributes - IBitmapControl 


Figure 4 (Page 1 of 2). Attributes - IBitmapControl. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

alignment 

■ 


Alignment 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

bitmap 

■ 


IBitmapHandle 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

defaultPushButton 



I Windo wHandle 

di sabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

fillBackground 

■ 

■ 

Boolean 

fillColor 

■ 

■ 

IColor 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

halftone 

■ 

■ 

Boolean 

handle 



I Windo wHandle 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

limit 

■ 

■ 

unsigned long 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parents ize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 
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Figure 4 (Page 2 of 2). Attributes - 

- IBitmapControl. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

strikeout 

■ 

■ 

Boolean 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

underscore 

■ 

■ 

Boolean 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IBitmapControl 

Figure 5 (Page 1 of 2). Actions - IBitmapControl 


Action Parameters 


applyBidiSettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh=tme 

Boolean capture=tm& 

con vertT oGUIS ty le 

IBitFlag& style 

disable 

disableFillBackground 

disableGroup 

disableHalftone 

disableNotification 

disableStrikeout 

disableTabStop 

disableUnderscore 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly=fa\st 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tmQ 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

IEvent& exceptionEvent 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

IWindowHandle& sibling Window 

positionBehindSiblings 

positionOnSiblings 

postEvent 

unsigned long eventld 

refresh 

IEventParameterl& parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 
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Figure 5 (Page 2 of 2). Actions - IBitmapControl 

Action Parameters 


releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFillColor 

resetFont 

resetForegroundColor 

resetHiliteBackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 


IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
Boolean visible= true 
Boolean show= true 


Events - IBitmapControl 

Figure 6. Events - IBitmapControl 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


General Settings - IBitmapControl 

DLL name 

Sets the name of the DLL file to be loaded. 
Default value: None 
Resource Id 

Sets the resource identifier for the part. 

Default value: 0 
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Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

Limit 

Sets the length (in bytes) of the longest text the part can hold. 

Default value: 0 
Alignment 

Changes the alignment of the part. 

Default value: Upper left 
Word wrap 

Enables word wrap of text around at the end of a line. 

Default value: Not selected 


Control Settings - IBitmapControl 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Chapter 4. IBitmapControl 27 



Styles Settings - IBitmapControl 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
sizeToBitmap 

Sizes the window to the size of the currently set bitmap. 

Default value: The Default radio button is selected. 

mnemonic 

Draws the next character with mnemonic emphasis if a mnemonic prefix character 
is found. 

Default value: The Default radio button is selected. 

fillBackground 

Erases the background, using the currently set fill color before drawing the text. 
Default value: The default is on, and the Default radio button is selected. 

halftone 

Draws the text in halftone color. 

Default value: The default is off, and the Default radio button is selected. 

strikeout 

Draws the text with overstriking. 

Default value: The default is off, and the Default radio button is selected. 

underscore 

Draws the text with underscoring. 

Default value: The default is off, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 
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clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 
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Handlers Settings - IBitmapControl 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IBitmapControl 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text that surrounds the part 

Fill 

Sets the color for the area of the part that is not occupied by text 

Default value: Foreground is selected 
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Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the static text. 

Default value: Red=0, Green=0, Blue=170 


Size/Position Settings - IBitmapControl 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
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Width 

Sets the minimum-allowable width, which is set by the user’s class. 
Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 
Default value: None (calculated at execution time) 


Font Settings - IBitmapControl 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 5. ICanvas 

ICanvas 
ICanvas 
IControl 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 



An ICanvas part is a background part for the client area of a frame window. Think 
of a canvas as a drawing board for the placement of control parts. 

The user interacts with controls placed on a canvas, not with the canvas itself. 

Use an ICanvas part to fill in a framework, such as one of the following: 

• The client area of a frame window 

• A view port 

• A notebook page 

You can then place other parts on the canvas, effectively placing the parts within the 
framework. 

You can also use a canvas as the base part for a composite part. Then, you can add 
the canvas with its controls as a subpart on a canvas in another composite part. 

The placement and size of controls on an ICanvas is fixed. They are not adjustable 
for different display resolutions or for national language support. 

Alternatively, use one of the following canvases: 

• ISplitCanvas for split windows 

• ISetCanvas for canvas cells in uniform rows or columns 

• IMultiCellCanvas to provide freely arranged canvas cells 


© Copyright IBM Corp. 1995 
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Building Guidelines - ICanvas 

When building with an ICanvas part, you can do the following: 

• Add a handler for all parts on the canvas. Do this as follows: 

- Add the handler name and parameters in the Handler list field on the 
ICanvas Handlers settings page. 

- Type the .hpp file name for the handler in the Class Editor Required 
include files field. 

• Change the font for all parts on the canvas. Do this by selecting a font on the 
ICanvas Font settings page. 

• Change the background color of the canvas. Do this by selecting a color from 
the Colors field or by setting RGB values in the RGB values field on the 
ICanvas Color settings page. 


Attributes - ICanvas 


Figure 7 (Page 1 of 2). Attributes ■ 

■ ICanvas. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroy Window 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

defaultPushButton 



I Windo wHandle 

di sabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



I Windo wHandle 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 
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Actions 


Figure 7 (Page 2 of 2). Attributes - 

■ ICanvas. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

nativeRect 



IRectangle 

origDefaultButtonHandle 



IWindowHandle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


ICanvas 


Figure 8 (Page 1 of 2). Actions - ICanvas 


Action 

Parameters 

applyBidiSettings 

BidiSettings& settings 

Boolean childlnherit=tme 

Boolean refresh= true 

capturePointer 

Boolean captur e=tme 

con vertT oGUIS ty le 

IBitFlag& style 

Boolean extendedOnly=fa\se 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

IEvent& event 

Boolean callDefProc= true 

enable 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow= true 

handleException 

IException& dispatcherException 

IEvent& exceptionEvent 

hide 

hideSourceEmphasis 

isLayoutDistorted 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

positionBehindSiblings 

IWindowHandle& siblingWindow 

positionOnSiblings 

postEvent 

unsigned long eventld 

IEventParameterl& parml=0 

IEventParameter2& parm2= 0 
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Figure 8 (Page 2 of 2). Actions - ICanvas 

Action 

Parameters 

refresh 

IRectangle& invalidRectangle 

releasePointer 


releasePresSpace 

IPresSpaceHandle& presentationSpaceHandle 

resetActiveColor 


resetB ackgroundColor 


resetBorderColor 


resetDisabledB ackgroundColor 


resetDisabledForegroundColor 


resetFont 


resetForegroundColor 


resetHiliteB ackgroundColor 


resetHiliteForegroundColor 


resetlnactiveColor 


resetMinimumSize 


resetShadowColor 


sendEvent 

unsigned long eventld 


IEventParameter 1 & parml=0 


IEventParameter2& parm2= 0 

setFocus 


setLayoutDistorted 

unsigned long lay outAttribute sOn 


unsigned long lay outAttribute sOff 

show 

Boolean visible= true 

showSourceEmphasis 

Boolean show= true 


Events - ICanvas 


Figure 9. Events - ICanvas 


Event 

Notification ID 

commandEvent 

commandld 

gotFocusEvent 

FOCUSTRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 

General Settings - ICanvas 


Subpart name 


Sets the name of the subpart (a part placed on a composite part). 

Default value: The name 

of the part 
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Control Settings - ICanvas 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - ICanvas 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 
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clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - ICanvas 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 
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Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ICanvas 

Color area 

Sets the color of the given area. Choices are as follows: 

Background 

Sets the color for background text 

Default value: Background is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the canvas. 

Default value: Red=255, Green=255, Blue=255 


Size/Position Settings - ICanvas 

X field 

Sets the X coordinate of the part if it is not the client part. 
Default value: Not available 
Y field 

Sets the Y coordinate of the part if it is not the client part. 
Default value: Not available 
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Width 

Sets the width of the canvas, if it is not the client part. 

Default value: Not available 
Height 

Sets the height of the canvas, if it is not the client part. 

Default value: Not available 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - ICanvas 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
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Edit 

Opens an edit field on a part or setting. 
Default value: Highlighted 
Default font 

Sets the current default font style. 
Default value: Not highlighted 
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Chapter 6. ICheckBox 

IBM 2-state check-box control 
ICheckBox 
ISettingButton 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


V CheckBoxI 
CheckBox2 

V CheckBox3 


An ICheckBox part is a square box with text that represents a settings choice. A 
mark in the check box indicates that the choice is selected. 

The user can select a choice by selecting an unmarked check box. The user can 
deselect the choice by selecting it again, unmarking the check box. 

Use an ICheckBox part to provide a settings choice that has two clearly 
distinguishable states, for example, on and off. 

Use check boxes in a group to provide multiple choices that are not mutually 
exclusive. Alternatively, use a group of IRadioButton parts for a set of mutually 
exclusive choices. 


Building Guidelines - ICheckBox 

When building with an ICheckBox part, you can do the following: 

• Set the text for the check box. Do this by entering the text you want in the Text 
field on the ICheckBox General settings page. 

• Set the initial state of the check box. Do this by selecting or deselecting the 
Selected field on the ICheckBox General settings page. 

To initially select your check box, make sure the Selected field check box is 
checked. If it is not checked, click on it with mouse button 1 to select it. 

To initially not select your check box, make sure the Selected field check box is 
not checked. If it is checked, click on it with mouse button 1 to deselect it. 
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• Allow the user to reach the check box by using a tab key. Do this by setting the 
tabStop field to On on the ICheckBox Styles settings page. 

• If the check box is the first control in a group, allow the user to use cursor keys 
to move between the check box and follow controls in the group. Do this by 
setting the group field to On on the ICheckBox Styles settings page. 

• Enable or disable another control when the user selects the check box. 

Enable the other control by connecting the ICheckBox selected attribute to the 
enabled attribute of the other control. When the user deselects the check box, the 
other control is disabled. 

Disable the other control by connecting the ICheckBox selected attribute to the 
value attribute of an IVBBooleanPart and then connecting the IVBBooleanPart 
notValue attribute to the enabled attribute of the other control. When the user 
deselects the check box, the other control is enabled. 

IVBBooleanPart is available in the vbsample.vbb file. 

• Enable or disable the check box when an event occurs. 

Enable the check box as follows: 

1. Connect the event to the ICheckBox enable action. 

2. The check box is enabled by default. If you have changed this default, open 
settings for the connection, press the Set parameters push button, and check 
the Enabled setting. 

Disable the check box by connecting the event to the ICheckBox disable action. 


Attributes - ICheckBox 


Figure 10 (Page 1 of 2). Attributes ■ 

■ ICheckBox. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

allowsMouseClickFocus 

■ 


Boolean 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

autoSelect 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

defaultPushButton 



I Windo wHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 
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Figure 10 (Page 2 of 2). Attributes ■ 

■ ICheckBox. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

highlighted 



Boolean 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

selected 

■ 


Boolean 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Chapter 6. ICheckBox 45 



Actions - ICheckBox 

Figure 11 (Page 1 of 2). Actions - ICheckBox 

Action Parameters 

applyBidiSettings BidiSettings& settings 

Boolean childlnherit= true 
Boolean refresh= true 

capturePointer Boolean capture=tme 

click 

convertToGUIStyle IBitFlag& style 

Boolean extendedOnly= false 

deselect 

disable 

disableAutoSelect 

disableGroup 

disableMouseClickFocus 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers IEvent& event 

enable 

enableUpdate 
handleException 

hide 

hideSourceEmphasis 
highlight 
isLayoutDistorted 
matchForMnemonic 
notifyObservers 
positionBehindSibling 
positionBehindSiblings 
positionOnSiblings 
postEvent 

refresh 

releasePointer 
releasePresSpace 
resetActiveColor 
resetB ackgroundColor 
resetBorderColor 
resetDisabledB ackgroundColor 
resetDisabledForegroundColor 
resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 
resetMinimumSize 
resetShadowColor 

sendEvent unsigned long eventld 


Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tmQ 
IException& dispatcherException 
IEvent& exceptionEvent 

Boolean highlight= true 
unsigned long layoutAttribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
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Figure 11 (Page 2 of 2). Actions - ICheckBox 

Action Parameters 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 

unhighlight 


IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 

unsigned long lay outAttribute sOn 
unsigned long layoutAttributesOff 
Boolean visible= true 
Boolean show= true 


Events - ICheckBox 

Figure 12. Events - ICheckBox 

Event Notification ID 


buttonClickEvent 

commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


buttonClickld 

commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


General Settings - ICheckBox 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

Selected 

Sets the selection state of the item to selected. 

Default value: Not selected 
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Control Settings - ICheckBox 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - ICheckBox 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
autoSelect 

Lets the user change the current selection by moving the cursor. 

Default value: The default is on, and the Default radio button is selected. 

noPointerFocus 

Allows the cursor stay on a control for which information is required, rather than 
moving to the button. Buttons with this style do not set the focus to themselves 
when the user clicks on them using the mouse. This has no effect on keyboard 
interaction. 

Default value: The Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 
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Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Chapter 6. ICheckBox 49 



Handlers Settings - ICheckBox 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ICheckBox 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 
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Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - ICheckBox 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
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value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - ICheckBox 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 7. ICircularSlider 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM circular slider control 

ICircularSlider 

ITextControl 

Visual part 

vbbase.vbb 



An ICircularSlider part shows a range of selection values. A circular dial represents 
the range of values. A slider arm marks the selected value. 

The user moves the arm around the dial to change the selected value. The user can 
move the arm in any of the following ways: 

• Drag it with the mouse. 

• Click or press a slider button to move the arm in the direction indicated on the 
button. This moves the arm by rotation increments defined for the slider. 

• Click on a tick mark representing a value in the slider range to move the arm 
directly to the tick mark. 

Use an ICircularSlider part to provide a range of seemingly nondiscrete selection 
values, such as degrees of brightness or loudness. 


Building Guidelines - ICircularSlider 

When building with an ICircularSlider part, you can do the following: 

• Define the value scale for the circular slider. Do this as follows: 

- Define the value range for the circular slider. Do this by entering Arm 
Range values in the Lower and Upper fields on the ICircularSlider General 
settings page. 
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Determine the rotation increment for arm movement. Do this by entering an 
increment value in the Rotation increment field on the ICircularSlider 
General settings page. 
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• Define an initial value for the circular slider. Do this by entering a value in the 
Current value field on the ICircularSlider General settings page. The arm is 
initially positioned at this value. 

• Provide the selected value to an attribute in another part or to an action 
parameter. Do this by connecting the ICircularSlider value attribute to the target 
attribute or action connection parameter. 


Attributes - ICircularSlider 

Figure 13 (Page 1 of 2). Attributes - ICircularSlider. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

armRange 

■ 

IRange 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroy Window 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidiSupported 


Boolean 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

clipboardHasTextFormat 


Boolean 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

displaySize 


ISize 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


I Windo wHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 

menu 


IRectangle 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

owner 

■ 

I Window* 

parent 

■ 

I Window* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 
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Figure 13 (Page 2 of 2). Attributes 

ICircularSlider. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

radius 



unsigned long 

rect 

■ 


IRectangle 

rotationlncrement 

■ 


unsigned long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

tickSpacing 

■ 


unsigned long 

valid 



Boolean 

value 

■ 

■ 

long 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - ICircularSlider 

Figure 14 (Page 1 of 2). Actions - ICircularSlider 


Action Parameters 


applyBidiSettings 

BidiSettings& settings 

Boolean childlnherit= true 

Boolean refresh-ime. 

capturePointer 

Boolean capture=tm& 

con vertT oGUIS ty le 

IBitFlag& style 

Boolean extendedOnly= false 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

IEvent& event 

Boolean callDefProc= true 

enable 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tmQ 

handleException 

IException& dispatcherException 
IEvent& exceptionEvent 

hide 

hideSourceEmphasis 

isLayoutDistorted 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

positionBehindSiblings 

IWindowHandle& siblingWindow 

positionOnSiblings 

postEvent 

unsigned long eventld 
IEventParameterl& parml=0 
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Figure 14 (Page 2 of 2). Actions - ICircularSlider 

Action Parameters 


refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteBackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setDecrementBitmaps 

setFocus 

setlncrementBitmaps 

setLayoutDistorted 

show 

showSourceEmphasis 


IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IBitmapHandle& leftUp 
IBitmapHandle& leftDown 

IResourceId& rightUp 
IResourceId& rightDown 
unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOjf 
Boolean visible=tme 
Boolean show= true 


Events - ICircularSlider 

Figure 15. Events - ICircularSlider 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIB LETRUEID 
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General Settings - ICircularSlider 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Lower 

Sets the lower range of the slider dial. 

Default value: 0 
Upper 

Sets the higher range of the slider dial. 

Default value: 0 
Rotation increment 

Sets the incremental value by which the user can rotate the dial by turning it with 
the mouse. 

Default value: 1 

Current value 

Sets the current incremental value by which the user can rotate the dial. 

Default value: 15 


Control Settings - ICircularSlider 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
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Enabled 

Enables the handler by default. 
Default value: Selected 


Styles Settings - ICircularSlider 

defaultStyle() 

Resets the part to the original default style. 

Default value: Selected 
buttons 

Sets the the style for the circular slider buttons. 

Default value: The Default radio button is selected. 

display Value 

Displays the currently selected value on the dial for the part. 

Default value: The Default radio button is selected. 

jumpToPointer 

Sets the value to the point you select on the dial by clicking on it. 
Default value: The Default radio button is selected. 

full360 

Sets the dial so the user can turn it up to 360 degrees. 

Default value: The Default radio button is selected. 

midpoint 

Displays a mark at the midpoint on the dial. 

Default value: The Default radio button is selected. 

proportionalTicks 

Sets the tick marks to be porportional to the values possible on the dial. 
Default value: The Default radio button is selected. 
noTicks 

Does not display tick marks on the dial. 

Default value: The Default radio button is selected. 

circular Arm 

Sets the indicator to appear as a dial. 

Default value: The Default radio button is selected. 
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group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 
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visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - ICircularSlider 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Size/Position Settings - ICircularSlider 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 
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Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - ICircularSlider 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 
Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
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Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 8. IColIectionViewComboBox 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM collection combination-box control 

ICollection V ie wComboBox 

IBaseComboBox 

Visual part 

vbbase.vbb 



An IColIectionViewComboBox part is a selection list and entry field for collection 
object choices. 

With an IColIectionViewComboBox, the user can select an object from the list box. 
Unless you prevent input in the entry field, the user can also do either of the 
following: 

• Type the beginning of a selection that is in the list. The closest match from the 
list is used. 

• Type a selection that is not in the list. 

If you define the combination box as a drop-down or read-only drop-down type, the 
user does not initially see the list box but can click a drop-down button to open it. 

Use one of the following IColIectionViewComboBox types to give the user object 
selection choices: 

Drop-down 

Allows the user to type a choice or to select a choice from a drop-down list. 

Read-only drop-down 

Allows the user only to select a choice from a drop-down list. 

Simple 

Allows the user to type a choice or to select a choice from a list that is always 
displayed. 


© Copyright IBM Corp. 1995 
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Alternatively, for object selection only from a list that is always displayed, use an 
ICollectionViewListBox part. You can provide either single or multiple selection 
with a list box part. 

For selection of strings rather than objects in a collection, use an IComboBox part or 
an IListBox part. 


Building Guidelines - ICollectionViewComboBox 

When building with an ICollectionViewComboBox part, you can do the following: 

• Select a collection object combination box type. Do this by selecting one of the 
following choices in the Combo box type field on the 
ICollectionViewComboBox General settings page: 

- Simple for a combination box with the list always open 

- Drop-down for a drop-down combination box with an editable entry field 

- Read-only drop-down for a drop-down combination box with a read-only 
entry field 

• Define the type of object supported by the combination box. Do this by entering 
a pointer to the part type (part type and *) in the Item type field on the 
ICollectionViewComboBox General settings page. 

• Define the type of collection containing the objects. The collection type is 
defined by the Collection type field on the ICollectionViewComboBox General 
settings page. The default collection type is IVSequence. If you are providing 
support for another collection type that you want to use, enter the type in this 
field. The vbcc.vbb data file contains examples of other collection types you 
could use. 

• Identify a function or class that provides strings for list items. Do this in either 
of the following ways: 

- Provide an asString override function that produces the text you want for the 
collection object class. The function could retrieve and return a key text 
attribute for the object. 

- Provide a string generator class that produces the text you want for the 
collection object class. The string generator could retrieve and return a key 
text attribute for the object. The generator class must be derived from the 
collection object class and must be a template class. 

If you use a string generator, enter the name of the generator class in the 
String generator field on the ICollectionViewComboBox General settings 
page. If this field is left empty, the default string generator calls asString for 
each collection object. 
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• Define initial selection choices for the combination box. Do this by connecting 
the this attribute of a collection part containing the choices to the 
ICollectionViewComboBox items attribute. A collection part that has one 
template argument, such as an IVSequence part, must be used. 

• Define a default selection for the combination box. Do this by specifying the 
1-based index of the selection in the Selection index field on the 
ICollectionViewComboBox General settings page. The corresponding choice in 
the collection part is the default selection. 

• Allow the user to reach the combination box by using a tab key. Do this by 
setting the tabStop field to On on the ICollectionViewComboBox Styles settings 
page. 

• Copy the text selection from the combination box to an entry field. Do this by 
connecting the ICollectionViewComboBox text attribute to the text attribute of 
the IEntryField. 

• Copy the index of the selection to a numeric field. Do this by connecting the 
ICollectionViewComboBox selection attribute to the target numeric field. 

• Add a new choice to the combination box list. Do this by adding the choice to 
the collection part that contains the choices. 

• Remove the selected choice from combination box list. Do this by removing the 
choice from the collection part that contains the choices. 


Attributes - ICollectionViewComboBox 


Figure 16 (Page 1 of 3). Attributes - ICollectionViewComboBox. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObject 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

autoScroll 

■ 


Boolean 

autoTab 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

changed 



Boolean 

characters ize 



ISize 

charType 

■ 


CharType 

clipboardHasT extFormat 



Boolean 

command 

■ 

■ 

Boolean 

count 



unsigned long 

cursorPosition 

■ 


unsigned long 

defaultPushButton 



IWindowHandle 

disabledB ackgroundColor 

■ 

■ 

IColor 
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Figure 16 (Page 2 of 3). Attributes - ICollectionViewComboBox. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

empty 



Boolean 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

hasSelectedText 



Boolean 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

horizontalScroll 



Boolean 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

insertMode 

■ 

■ 

Boolean 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

items 

■ 

■ 

Collection* 

lay out Adjustment 



IRectangle 

leftlndex 

■ 


unsigned long 

limit 

■ 

■ 

unsigned long 

listShowing 



Boolean 

margin 

■ 


Boolean 

menu 




messageQueue 



IMessageQueueHandle 

minimumRows 

■ 


unsigned long 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

numberOfSelections 



unsigned long 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

readonly 



Boolean 

rect 

■ 


IRectangle 

selectedCollectionPosition 



unsigned long 

selectedElement 



Element 

selectedRange 



IRange 

selectedText 



IString 

selectedT extLength 



unsigned long 

selection 



long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

stringGenerator 

■ 


IStringGenerator < Element >& 

tabStop 

■ 


Boolean 
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Figure 16 (Page 3 of 3). Attributes - ICollectionViewComboBox. (S is Set, E is Event) 

Attribute S E Data type 


text 

textLength 

top 

type 

valid 

valueAsDouble 

valueAsInt 

valueAsUnsigned 

visible 

visibleRectangle 

writeable 


IString 

unsigned long 
unsigned long 
ControlType 
Boolean 


Boolean 

IRectangle 

Boolean 


Actions - ICollectionViewComboBox 

Figure 17 (Page 1 of 3). Actions - ICollectionViewComboBox 

Action Parameters 


applyBidiSettings 

capturePointer 

clear 

collectionReplaced 

con vertT oGUIS ty le 

copy 

cut 

deselect 

deselectAll 

disable 

disableAutoScroll 

disable AutoTab 

disableCommand 

disableDataUpdate 

disableGroup 

disablelnsertMode 

disableMargin 

disableNotification 

disableTabStop 

disableUpdate 

discard 

dispatchRemainingHandlers 

elementAdded 

elementChanged 

elementDeleted 

elementsChanged 

enable 


BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh=tme 
Boolean capture=ime 
unsigned long timestamp=0 

IBitFlag& style 
Boolean extendedOnly= false 
unsigned long timestamps 0 
unsigned long timestamp=0 
unsigned long index 


IEvent& event 
Boolean callDefProc= true 
unsigned long position 
Element& element 
unsigned long position 
Element& element 
unsigned long position 

Boolean enabled= true 
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Figure 17 (Page 2 of 3). Actions - ICollectionViewComboBox 

Action Parameters 


enableUpdate 

handleException 

hide 

hideList 

hideSourceEmphasis 

isLayoutDistorted 

isSelected 

itemHandle 

itemText 

locateText 


matchForMnemonic 

notifyObservers 

paste 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

removeAll 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

select 

selectRange 

sendEvent 


setChangedFlag 

setFocus 

setltemHandle 

setltemText 


Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 


unsigned long layoutAttribute 
unsigned long index 
unsigned long index 
unsigned long index 
char* searchString 
Boolean caseSensitive=true 
SearchType search=ex actMatch 
unsigned long index= first 
unsigned short character 
INotificationEvent& event 

IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long index 
Boolean select= true 
const IRange &range =IRange(0,end) 
unsigned long timestamp=0 
unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
Boolean changeFlag= true 

unsigned long index 
unsigned long handle 
unsigned long index 
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Figure 17 (Page 3 of 3). Actions - ICollectionViewComboBox 

Action Parameters 

char* string 

Boolean update Entry Fie ld= false 

setLayoutDistorted unsigned long layoutAttributesOn 

unsigned long lay outAttribute sOff 

show Boolean visible= true 

showList Boolean show= true 

showSourceEmphasis Boolean show= true 

Events - ICollectionViewComboBox 


Figure 18. Events - ICollectionViewComboBox 

Event 

Notification ID 

characterTypeEvent 

characterTypeld 

commandEvent 

commandld 

enterEvent 

enterld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABT.ETRtIF.TD 

itemChangedEvent 

itemChangedld 

lostFocusEvent 

FOCU SFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VTSIBTF.FAT.SEin 

visibilityEnabledEvent 

VISIBLETRUEID 


General Settings - ICollectionViewComboBox 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Item type 

Specifies the part type of objects in the collection. 

Default value: None 
Collection type 

Specifies the part type of the collection. 

Default value: IVSequence* 

String generator 

Specifies the name of a string generator class that produces text to represent objects 
in the collection. 

Default value: None 
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Auto scroll 

Enables automatic scrolling for the part. 

Default value: Not selected 
Margin 

Draws a border around the entry field, with a margin between the border and the 
entry field. For a canvas, the margin width and height are returned, which is the 
space between the edge of the canvas and the outermost child windows. 

Default value: Not selected 

Auto tab 

Generates a tab key when the part is filled by adding a character at the text limit of 
the part text. 

Default value: Not selected 

Insert mode 

Sets insert mode to on. 

Default value: Selected 
Limit 

Sets the length (in bytes) of the longest text the part can hold. 

Default value: 260 
Combo box type 

Sets the behavior of the combination box, which can be one of the following: 

Simple 

Specifies that the entry field and list box controls are visible. When the 
selection changes in the list box control, the text of the selected item in the list 
box control is placed in the entry field. You can also select an item from the list 
box control by entering part of the item into the entry field. The entry is 
completed with the closest match from the list box. 

Drop-down 

Specifies the drop-down variation of the combination box. The list box control 
is hidden until the user requests that it be displayed. 

Read-only drop-down 

Specifies the drop-down list variation of the combination box. The drop-down 
list only displays one item in the entry field until the user displays the list box 
control to make alternative selections from the list box. The user cannot enter 
information into the entry field portion of the drop-down list. The entry field 
control is replaced by a static control that displays the current selection from the 
list box. 

Default value: Square 
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Character type 

Sets the type of a character at a given index. 

Default value: Any 


Control Settings - ICollectionViewComboBox 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - ICollectionViewComboBox 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
horizontals cr oil 

Provides a horizontal scroll bar for the part. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 
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tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 
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Handlers Settings - ICollectionViewComboBox 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ICollectionViewComboBox 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 
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Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - ICollectionViewComboBox 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
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value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - ICollectionViewComboBox 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 9. ICollectionViewListBox 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


ICollectionViewListBox 

ICollectionViewListBox 

IBaseListBox 

Visual part 

vbbase.vbb 



An ICollectionViewListBox part is a selection list for collection object choices. 

By default, the user can select only one choice from the list. When the user selects a 
choice, any previously selected choice is no longer selected. You can change the 
behavior of the list box to allow multiple selection. 

Use an ICollectionViewListBox part to provide a modifiable list of object choices for 
the user. Your application can add or remove choices from the list. 

Alternatively, for object selection from an entry field or a drop-down list, use one of 
the following ICollectionViewComboBox types: 

Drop-down 

Allows the user to type a choice or to select a choice from a drop-down list. 

Read-only drop-down 

Allows the user only to select a choice from a drop-down list. 

Simple 

Allows the user to type a choice or to select a choice from a list that is always 
displayed. 

You can provide only single selection with a combination box part. 

For selection of strings rather than objects in a collection, use an IComboBox part or 
an IListBox part. 


© Copyright IBM Corp. 1995 
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Building Guidelines - ICollectionViewListBox 

When building with an ICollectionViewListBox part, you can do the following: 

• Define the type of object supported by the list box. Do this by entering a pointer 
to the part type (part type and *) in the Item type field on the 
ICollectionViewListBox General settings page. 

• Define the type of collection containing the objects. The collection type is 
defined by the Collection type field on the ICollectionViewListBox General 
settings page. The default collection type is IVSequence. If you are providing 
support for another collection type that you want to use, enter the type in this 
field. The vbcc.vbb data file contains examples of other collection types you 
could use. 

• Identify a function or class that provides strings for list items. Do this in either 
of the following ways: 

- Provide an asString override function that produces the text you want for the 
collection object class. The function could retrieve and return a key text 
attribute for the object. 

- Provide a string generator class that produces the text you want for the 
collection object class. The string generator could retrieve and return a key 
text attribute for the object. The generator class must be derived from the 
collection object class and must be a template class. 

If you use a string generator, enter the name of the generator class in the 
String generator field on the ICollectionViewListBox General settings 
page. If this field is left empty, the default string generator calls asString for 
each collection object. 

• Define initial selection choices for the list box. Do this by connecting the this 
attribute of a collection part containing the choices to the ICollectionViewListBox 
items attribute. A collection part that has one template argument, such as an 
IVSequence part, must be used. 

• Allow the user to select more than one choice from the list. Do this by selecting 
the muItipleSelection field on the ICollectionViewListBox Styles settings page. 

• Allow the user to reach the list box by using a tab key. Do this by setting the 
tabStop field to On on the ICollectionViewListBox Styles settings page. 

• Copy the selected object from the list box to an IVBVariable. Do this by 
connecting the ICollectionViewListBox selectedElement attribute to the text 
attribute of the variable. 

• Copy the index of the selection to a numeric field. Do this by connecting the 
ICollectionViewListBox selection attribute to the target numeric field. 
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• Add a new choice to the list box. Do this by adding the choice to the collection 
part that contains the choices. 

• Remove the selected choice from the list box. Do this by removing the choice 
from the collection part that contains the choices. 


Attributes - ICollectionViewListBox 


Figure 19 (Page 1 of 2). Attributes - ICollectionViewListBox. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObject 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

count 



unsigned long 

defaultPushButton 



IWindowHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

drawltem 

■ 


Boolean 

empty 



Boolean 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

extendedSelect 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

horizontalScroll 



Boolean 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

items 

■ 

■ 

Collection* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumCharacters 

■ 


unsigned long 

minimumRows 

■ 


unsigned long 

minimumSize 

■ 


ISize 

multipleSelect 

■ 


Boolean 

nativeRect 



IRectangle 

noAdjustPosition 

■ 


Boolean 

numberOfSelections 



unsigned long 

owner 

■ 


IWindow* 
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Figure 19 (Page 2 of 2). Attributes - ICollectionViewListBox. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

parent 

■ 


IWindow* 

parents ize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

selectedCollectionPosition 



unsigned long 

selectedElement 



Element 

selection 



long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

stringGenerator 

■ 


IStringGenerator < Element >& 

tabStop 

■ 


Boolean 

top 

■ 


unsigned long 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - ICollectionViewListBox 

Figure 20 (Page 1 of 3). Actions - ICollectionViewListBox 


Action Parameters 


applyBidiSettings 

BidiSettings& settings 

Boolean childlnherit= true 
Boolean refresh-\x\\Q 

capturePointer 

collectionReplaced 

Boolean capture=tme 

con vertT oGUISty le 

IBitFlag& style 

Boolean extendedOnly= false 

deselect 

deselectAll 

disable 

disableDrawItem 

disableExtendedSelect 

disableGroup 

disableMultipleSelect 

disableNoAdjustPosition 

disableNotification 

disableTabStop 

disableUpdate 

unsigned long index 

dispatchRemainingHandlers 

IEvent& event 

Boolean callDefProc=tniQ 

elementAdded 

unsigned long position 
Element& element 

elementChanged 

unsigned long position 
Element& element 

elementDeleted 

elementsChanged 

unsigned long position 
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Figure 20 (Page 2 of 3). Actions - ICollectionViewListBox 

Action Parameters 


enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

isS elected 

itemHandle 

itemText 

locateText 


matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

select 

selectAll 

selectedElements 

sendEvent 


setFocus 

setltemHandle 

setltemHeight 

setltemText 

setLayoutDistorted 


Boolean enabled= true 
Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 


unsigned long lay out Attribute 
unsigned long index 
unsigned long index 
unsigned long index 
char* searchString 
Boolean caseSensitive= true 
SearchType search=&x actMatch 
unsigned long index= first 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long index 
Boolean select= true 

Collection& elements 
unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 

unsigned long index 
unsigned long handle 
unsigned long newHeight 
unsigned long index 
IResourceId& string 
unsigned long layoutAttributesOn 
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Figure 20 (Page 3 of 3). Actions - ICollectionViewListBox 


Action 

Parameters 

show 

unsigned long lay outAttribute sOff 

Boolean visible=tme 

showSourceEmphasis 

Boolean show=t rue 


Events - ICollectionViewListBox 

Figure 21. Events - ICollectionViewListBox 

Event 

Notification ID 

commandEvent 

commandld 

enterEvent 

enterld 

extendedSelectChangedEvent 

extendedSelectChangedld 

gotFocusEvent 

FOCUSTRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

itemChangedEvent 

itemChangedld 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 


General Settings - ICollectionViewListBox 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Item type 

Specifies the part type of objects in the collection. 

Default value: None 
Collection type 

Specifies the part type of the collection. 

Default value: IVSequence* 

String generator 

Specifies the name of a string generator class that produces text to represent objects 
in the collection. 

Default value: None 
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Control Settings - ICollectionViewListBox 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - ICollectionViewListBox 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
Draw item 

Allows the menu item to be drawn. 

Default value: Not selected 
horizontals cr oil 

Provides a horizontal scroll bar for the part. 

Default value: The default is on, and the Default radio button is selected. 

multipleSelect 

Sets the style of the part to multiple selection mode. 

Default value: The default is off, and the Default radio button is selected. 

noAdjustPosition 

Restricts adjustment of the frame position of the part. As a result, certain aspects 
of enhanced performance by such alignment are lost. 
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Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 
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visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - ICollectionViewListBox 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ICollectionViewListBox 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 


Chapter 9. ICollectionViewListBox 85 




Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - ICollectionViewListBox 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
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Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - ICollectionViewListBox 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 10. IComboBox 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM string combination-box control 

IComboBox 

IBaseComboBox 

Visual part 

vbbase.vbb 



An IComboBox part is a selection list and entry field for string choices. 

With an IComboBox, the user can select a string from the list box. Unless you 
prevent input in the entry field, the user can also do either of the following: 

• Type the beginning of a selection that is in the list. The closest match from the 
list is used. 

• Type a selection that is not in the list. 

If you define the combination box as a drop-down or read-only drop-down type, the 
user does not initially see the list box, but can click a drop-down button to open it. 

Use one of the following IComboBox types to give the user string selection choices: 

Drop-down 

Allows the user to type a choice or to select a choice from a drop-down list. 

Read-only drop-down 

Allows the user only to select a choice from a drop-down list. 

Simple 

Allows the user to type a choice or to select a choice from a list that is always 
displayed. 

Alternatively, for string selection only from a list that is always displayed, use an 
IListBox part. You can provide either single or multiple selection with a list box 
part. 
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For selection of objects in a collection rather than strings, use an 
ICollectionViewComboBox part or an ICollectionViewListBox part. 


Building Guidelines - IComboBox 

When building with an IComboBox part, you can do the following: 

• Select a string combination box type. Do this by selecting one of the following 
choices in the Combo box type field on the IComboBox General settings page: 

- Simple for a combination box with the list always open 

- Drop-down for a drop-down combination box with an editable entry field 

- Read-only drop-down for a drop-down combination box with a read-only 
entry field 

• Define initial selection choices for the combination box. Do this by entering the 
choices in the Contents field on the IComboBox General settings page. 

• Define a default selection for the combination box. Do this by specifying the 
0-based index of the selection in the Selection index field on the IComboBox 
General settings page. The corresponding choice in the Contents field is the 
default selection. 

• Allow the user to reach the combination box by using a tab key. Do this by 
setting the tabStop field to On on the IComboBox Styles settings page. 

• Copy the text selection from the combination box to an entry field. Do this by 
connecting the IComboBox text attribute to the text attribute of the IEntryField. 

• Copy the index of the selection to a numeric field. Do this by connecting the 
IComboBox selection attribute to the target numeric field. 

• Add a new choice to the combination box list from the entry field when a push 
button is pressed. Add the choice to the end of the list. Do this as follows: 

1. Connect the IPushButton buttonClickEvent feature to the addAsLast action of 
the IComboBox. 

2. Connect the IComboBox text attribute to the text parameter of the 
buttonClickEvent-to-addAsLast connection. This provides the entry field text 
as the parameter for the addAsLast action. 

• Remove the selected choice from the combination box list when a push button is 
pressed. Do this as follows: 

1. Connect the IPushButton buttonClickEvent feature to the remove action of 
the IComboBox. 


90 


Visual Builder Parts Reference 




2. Connect the IComboBox selection attribute to the index parameter of the 
buttonClickEvent-to-remove connection. This provides the selection index as 
the parameter for the remove action. 


Attributes - IComboBox 


Figure 22 (Page 1 of 2). Attributes - IComboBox. (S is Set, E is Event) 

Attribute S E Data type 


activeColor 

asDebuglnfo 

asString 

autoDeleteObject 

autoDestroyWindow 

autoScroll 

autoTab 

backgroundColor 

bidiSupported 

borderColor 

changed 

characters ize 

charType 

clipboardHasT extFormat 

command 

count 

cursorPosition 

defaultPushButton 

disabledBackgroundColor 

disabledForegroundColor 

displaySize 

empty 

enabled 

enabledForNotification 

focus 

font 

foregroundColor 

frameWindow 

group 

handle 

hasSelectedText 
hiliteB ackgroundColor 
hiliteForegroundColor 
horizontalScroll 
id 

inactiveColor 

insertMode 

isDigits 

itemProvider 

lay out Adjustment 

leftlndex 

limit 

listShowing 

margin 


IColor 

IString 

IString 

Boolean 

Boolean 

Boolean 

Boolean 

IColor 

Boolean 

IColor 

Boolean 

ISize 

CharType 

Boolean 

Boolean 

unsigned long 

unsigned long 

IWindowHandle 

IColor 

IColor 

ISize 

Boolean 

Boolean 

Boolean 

Boolean 

IFont 

IColor 

Boolean 

Boolean 

IWindowHandle 

Boolean 

IColor 

IColor 

Boolean 

unsigned long 

IColor 

Boolean 

IDMItemProvider* 
IRectangle 
unsigned long 
unsigned long 
Boolean 
Boolean 
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Actions 


Figure 22 (Page 2 of 2). Attributes ■ 

■ IComboBox. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

menu 




messageQueue 



IMessageQueueHandle 

minimumRows 

■ 


unsigned long 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

numberOfSelections 



unsigned long 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parents ize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

readonly 



Boolean 

rect 

■ 


IRectangle 

selectedRange 



IRange 

selectedText 



IString 

selectedT extLength 



unsigned long 

selection 



long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

top 

■ 


unsigned long 

type 



ControlType 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 

writeable 

■ 

■ 

Boolean 


IComboBox 


Figure 23 ( Page 1 of 3). Actions ■ 

- IComboBox 

Action 

Parameters 

add 

unsigned long index 


char * const* itemList 


unsigned long count= 1 

addAscending 

char* text 

addAsFirst 

char* text 

addAsLast 

IResourceId& item 

addDescending 

char* text 

applyBidiSettings 

BidiSettings& settings 


Boolean childlnherit= true 
Boolean refresh=tme 

capturePointer Boolean capture= true 
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Figure 23 (Page 2 of 3). Actions - IComboBox 


Action 

Parameters 

clear 

unsigned long timestamps 0 

con vertT oGUIS ty le 

IBitFlag& style 

copy 

Boolean extendedOnly=fd\se 
unsigned long timestamp=0 

cut 

unsigned long timestamps 0 

deselect 

unsigned long index 

deselectAll 

disable 

disableAutoScroll 

disable AutoTab 

disableCommand 

disableDataUpdate 

disableGroup 

disablelnsertMode 

disableMargin 

disableNotification 

disableTabStop 

disableUpdate 

discard 

dispatchRemainingHandlers 

IEvent& event 


Boolean callDefProc= true 
Boolean enable d= true 
Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 


unsigned long lay out Attribute 
unsigned long index 
unsigned long index 
unsigned long index 
char* searchString 
Boolean caseSensitive= true 
SearchType search=ex actMatch 
unsigned long index= first 
unsigned short character 
INotificationEvent& event 

IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameterl& parml= 0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
unsigned long index 

removeAll 

resetActiveColor 


enable 

enableUpdate 

handleException 

hide 

hideList 

hideSourceEmphasis 

isLayoutDistorted 

isSelected 

itemHandle 

itemText 

locateText 


matchForMnemonic 

notifyObservers 

paste 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

remove 
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Events 


Figure 23 (Page 3 of 3). Actions - IComboBox 


Action 

Parameters 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

select 

unsigned long index 

selectRange 

Boolean select= true 

const IRange &range =IRange(0,end) 

sendEvent 

unsigned long timestamp= 0 
unsigned long eventld 

setChangedFlag 

IEventParameter 1 & parml=0 

IEventParameter2& parm2= 0 

Boolean changeFlag= true 

setFocus 

setltemHandle 

unsigned long index 

setltemText 

unsigned long handle 
unsigned long index 

setLayoutDistorted 

char* string 

Boolean update Entry Fie ld=f alse 
unsigned long lay out Attribute sOn 

show 

unsigned long lay outAttribute sOff 

Boolean visible=tme 

showList 

Boolean show= true 

showSourceEmphasis 

Boolean show= true 


IComboBox 

Figure 24. Events - IComboBox 

Event 

Notification ID 

characterT y peEvent 

characterTypeld 

commandEvent 

commandld 

enterEvent 

enterld 

gotFocusEvent 

FOCUSTRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 
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General Settings - IComboBox 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

Selection index 

Sets the index of the specified choice. 

Default value: -1 
Auto scroll 

Enables automatic scrolling for the part. 

Default value: Not selected 
Margin 

Draws a border around the entry field, with a margin between the border and the 
entry field. For a canvas, the margin width and height are returned, which is the 
space between the edge of the canvas and the outermost child windows. 

Default value: Not selected 

Auto tab 

Generates a tab key when the part is filled by adding a character at the text limit of 
the part text. 

Default value: Not selected 

Insert mode 

Sets insert mode to on. 

Default value: Selected 
Limit 

Sets the length (in bytes) of the longest text the part can hold. 

Default value: 260 
Combo box type 

Sets the behavior of the combination box, which can be one of the following: 

Simple 

Specifies that the entry field and list box controls are visible. When the 
selection changes in the list box control, the text of the selected item in the list 
box control is placed in the entry field. You can also select an item from the list 
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box control by entering part of the item into the entry field. The entry is 
completed with the closest match from the list box. 

Drop-down 

Specifies the drop-down variation of the combination box. The list box control 
is hidden until the user requests that it be displayed. 

Read-only drop-down 

Specifies the drop-down list variation of the combination box. The drop-down 
list only displays one item in the entry field until the user displays the list box 
control to make alternative selections from the list box. The user cannot enter 
information into the entry field portion of the drop-down list. The entry field 
control is replaced by a static control that displays the current selection from the 
list box. 

Default value: Square 
Character type 

Sets the type of a character at a given index. 

Default value: Any 
Contents 

Sets initial items for the part. 

Default value: None 


Control Settings - IComboBox 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
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Enabled 

Enables the handler by default. 
Default value: Selected 


Styles Settings - IComboBox 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
horizontals cr oil 

Provides a horizontal scroll bar for the part. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 
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Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IComboBox 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
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Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IComboBox 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Size/Position Settings - IComboBox 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


100 


Visual Builder Parts Reference 



Font Settings - IComboBox 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 11. IContainerColumn 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM column for container details view 

IContainerColumn 

IVBase 

Class interface part 
vbbase.vbb 


Objects 


Column 1 

Column 2 

r 




Object 2 

Object 2 




1 


> 


An IContainerColumn part is a column for the details view of a container. The 
column contains information on a particular attribute of each container object. 

The user can view the column data for container objects. With modifiable text data, 
the user can edit the object attribute. 

Use an IContainerColumn part to define the heading and contents of a container 
details view column. 


Building Guidelines - IContainerColumn 

When building with an IContainerColumn part, you can do the following: 

• Add the column to a container control. Do this by selecting the 
IContainerColumn part from the parts palette and dropping the part on an 
IVBContainerControl. 

To gain access to the container column while building, select the 
showDetailsView choice in the View type field on the IVBContainerControl 
General settings page. 

• Define the column heading. Do this by entering the heading in the Heading text 
field on the IContainerColumn General settings page. 
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• Determine what data appears in the column. Do this in the Column definition 
field on the IContainerColumn General settings page. 

To show the text title of each container item, select the Use Text attribute set in 
the Container setting. The text presentation is set on the IVBContainerControl 
General settings page. 

To show an icon for each container item, select the Use Icon attribute set in the 
Container setting. The icon specification is set on the IVBContainerControl 
General settings page. 

To show an attribute of each container item, select the Use an attribute from 
the part setting. Then, select a choice from the Attributes list box. Only 
text-related attributes are available as choices. 


Attributes - IContainerColumn 


Figure 25. Attributes - IContainerColumn. 

(S is Set, E is Event) 

Attribute 

s 

E Data type 

asDebuglnfo 


IString 

asString 


IString 

date 


Boolean 

displayWidth 

■ 

unsigned long 

headinglcon 

■ 

IPointerHandle 

headinglconHandle 


Boolean 

headingstring 


Boolean 

headingText 

■ 

IString 

headingW riteable 

■ 

Boolean 

helpld 

■ 

unsigned long 

horizontalDataAlignment 


HorizontalAlignment 

horizontalHeadingAlignment 


HorizontalAlignment 

horizontalSeparator 


Boolean 

iconHandle 


Boolean 

number 


Boolean 

string 


Boolean 

time 


Boolean 

verticalDataAIignment 


V ertical Alignment 

verticalHeadingAlignment 


V ertical Alignment 

verticalSeparator 


Boolean 

visible 

■ 

Boolean 

writeable 

■ 

Boolean 
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Actions - IContainerColumn 

Figure 26. Actions - IContainerColumn 

Action Parameters 


dataAsDate 

dataAsIcon 

dataAsNumber 

dataAsString 

dataAsTime 

disableDataUpdate 

disableHeadingUpdate 

hide 

hideSeparators 

justifyData 

justifyHeading 

setDataOffset 

showSeparators 


IContainerObject* object 
IContainerObject* object 
IContainerObject* object 
IContainerObject* object 
IContainerObject* object 


DataStyle& separatorStyle s=hoxizoxita\Sepaxatox I 
verticalSeparator 

V ertical Alignment =IContainerColumn:: centered V ertically 
Horizontal Alignment =IContainerColumn:: centered 

V ertical Alignment =IContainerColumn:: centered V ertically 
Horizontal Alignment =IContainerColumn:: centered 
unsigned long dataOffset 

DataStyle& separatorStyles=hoxizoxita\Sepaxatox I 
verticalSeparator 


General Settings - IContainerColumn 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Heading text 

Sets the text for the column heading. 

Default value: None 
Width 

Sets the container column width. 

Default value: Determined by the size of column data. 

Column definition 

Sets the data to appear in the column. 

Default value: Foreground is selected 

Use Text attribute set in the Container 

Sets the title text to show for the container item. 

Default value: None 

Use Icon attribute set in the Container 

Sets the icon to show for the container item. 

Default value: None 
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Use an attribute from the part 

Sets the attribute to show for the container item. 

Default value: None 
Attributes 

Lists the available text-related attributes that you can select from to assign to the 
column. 

Default value: No choice is selected. 

Attribute type 

Displays the data type of the selected attribute. 

Default value: None when no attribute choice is selected. 

Column type 

Lists the available column data types for the selected attribute. 

Default value: None when no attribute choice is selected. 


Styles Settings - IContainerColumn 

defaultHeadingStyle() 

Resets the part to the original default heading style. 

Default value: Selected 
readOnlyHeading 

Prevents entering input into the heading field. 

Default value: The default is off, and the Default radio button is selected. 

icon 

The heading is an icon. 

Default value: The default is off, and the Default radio button is selected. 

defaultDataStyle() 

Resets the part to the original default data style. 

Default value: Selected 
date 

The data is displayed in date format and is enabled for National Language Support. 
Default value: The default is off, and the Default radio button is selected. 

time 

The data is displayed in time format and is enabled for National Language Support. 
Default value: The default is off, and the Default radio button is selected. 


106 


Visual Builder Parts Reference 



number 

The data is displayed as an unsigned long number. 

Default value: The default is off, and the Default radio button is selected. 

horizontalSeparator 

Provides a horizontal separator beneath the column heading. 

Default value: The default is on, and the Default radio button is selected. 

verticalSeparator 

Provides a vertical separator after the column. 

Default value: The default is on, and the Default radio button is selected. 

handleDrawItem 

Generates a draw item event to allow the application to draw the part. 
Default value: The Default radio button is selected. 

readonly 

Prevents entering input into the field. 

Default value: The default is off, and the Default radio button is selected. 

invisible 

The column is invisible. 

Default value: The default is off, and the Default radio button is selected. 

icon 

The data is an icon. 

Default value: The default is off, and the Default radio button is selected. 


Chapter 11. IContainerColumn 107 



108 Visual Builder Parts Reference 



Chapter 12. ICustomButton 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM custom button control 

ICustomButton 

IButton 

Visual part 

vbbase.vbb 


Play 


An ICustomButton part is a selection button for an action. The choice is identified 
by text on the custom button. Your application can customize a custom button. 

The user can click the custom button to perform the indicated function. 

Use an ICustomButton part to give the user an action choice button with the 
following capabilities: 

• The button can be customized. 

• The button can remain latched down when it is selected. 

A multimedia play button is an example of a custom button. 


Building Guidelines - ICustomButton 

When building with an ICustomButton part, you can do the following: 

• Assign text to the custom button. Do this by setting the Text field on the 
ICustomButton General settings page. 

• Assign a customization handler for the custom button. Do this by specifying an 
ICustomButtonDrawHandler on the ICustomButton Handlers settings page. 

• Give the button the appearance of remaining latched down while it is active. 

This simulates the behavior of such controls as a play button. Do this by setting 
the latchable field on the ICustomButton Styles settings page. 

• Allow the user to reach the button by using a tab key. Do this by setting the 
tabStop field to On on the ICustomButton Styles settings page. 

• If the button is the first control in a group, allow the user to use cursor keys to 
move between the button and follow controls in the group. Do this by setting the 
group field to On on the ICustomButton Styles settings page. 
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• Start the action represented by the button. Do this by connecting the 
ICustomButton buttonClickEvent feature to the action on the target part. 

• Enable or disable the custom button when an event occurs. 

Enable the button as follows: 

1. Connect the event to the ICustomButton enable action. 

2. The button is enabled by default. If you have changed this default, open 
settings for the connection, press the Set parameters push button, and check 
the Enabled setting. 

Disable the button by connecting the event to the ICustomButton disable action. 


Attributes - ICustomButton 


Figure 27 (Page 1 of 2). Attributes 

ICustomButton. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

allowsMouseClickFocus 

■ 


Boolean 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

autoLatchEnabled 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

defaultPushButton 



I Windo wHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



I Windo wHandle 

highlighted 



Boolean 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

latched 

■ 

■ 

Boolean 

latchedBackgroundColor 

■ 


IColor 

latchedBackgroundColorHalftone 



Boolean 
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Figure 27 (Page 2 of 2). Attributes ■ 

■ ICustomButton. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

latchedF oregroundColor 

■ 


IColor 

latchingEnabled 

■ 


Boolean 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabS top 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

userData 

■ 


unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - ICustomButton 

Figure 28 (Page 1 of 2). Actions - ICustomButton 

Action Parameters 


applyBidiSettings 

capturePointer 

click 

con vertT oGUIS ty le 
disable 

disableAutoLatch 

disableGroup 

disableLatching 

disableMouseClickFocus 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 


BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh^ true 
Boolean capture=tme 

IBitFlag& style 

Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc= true 
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Figure 28 (Page 2 of 2). Actions ■ 

■ ICustomButton 

Action 

Parameters 

enable 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow= true 

handleException 

IException& dispatcherException 


IEvent& exceptionEvent 

hide 


hideSourceEmphasis 


highlight 

Boolean highlight= true 

isLayoutDistorted 

unsigned long layoutAttribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

IWindowHandle& siblingWindow 

positionBehindSiblings 


positionOnSiblings 


postEvent 

unsigned long eventld 


IEventParameter 1 & parml=0 


IEventParameter2& parm2= 0 

refresh 

IRectangle& invalidRectangle 

releasePointer 


releasePresSpace 

IPresSpaceHandle& presentationSpaceHandle 

resetActiveColor 


resetBackgroundColor 


resetBorderColor 


resetDisabledBackgroundColor 


resetDisabledForegroundColor 


resetFont 


resetForegroundColor 


resetHiliteB ackgroundColor 


resetHiliteForegroundColor 


resetlnactiveColor 


resetLatchedBackgroundColor 


resetLatchedF oregroundColor 


resetMinimumSize 


resetShadowColor 


sendEvent 

unsigned long eventld 


IE ventParameter 1 & parml=0 


IEventParameter2& parm2= 0 

setFocus 


setLayoutDistorted 

unsigned long lay outAttribute sOn 


unsigned long lay outAttribute sOff 

show 

Boolean visible=tme 

showSourceEmphasis 

Boolean show=t rue 

unhighlight 


unlatch 
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Events - ICustomButton 


Figure 29. Events - ICustomButton 


Event 

Notification ID 

buttonClickEvent 

buttonClickld 

commandEvent 

commandld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VT.STBFF.TR UF.TD 

General Settings - ICustomButton 


Subpart name 


Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Text 


Sets the text for the part. 


Default value: The name of the part 

Latched 


Sets the part to the latched state. 


Default value: Not selected 



Control Settings - ICustomButton 


Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 

Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
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Enabled 

Enables the handler by default. 
Default value: Selected 


Styles Settings - ICustomButton 

defaultStyle() 

Resets the part to the original default style. 

Default value: Selected 
latchable 

Sets the default style to the latchable state. 

Default value: The Default radio button is selected. 

autoLatch 

Sets the default style for the part the automatic latch state. 

Default value: The Default radio button is selected. 

noPointerFocus 

Allows the cursor stay on a control for which information is required, rather than 
moving to the button. Buttons with this style do not set the focus to themselves 
when the user clicks on them using the mouse. This has no effect on keyboard 
interaction. 

Default value: The Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 
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clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - ICustomButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 
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Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ICustomButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Latched foreground 

Sets the foreground color for latched text 

Latched background 

Sets the background color for latched text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 
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RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - ICustomButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - ICustomButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 13. lEntryField 

IBM entry field control 
lEntryField 
ITextControl 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


An lEntryField part is a single-line entry field. 

The user can type or place text into the entry field. 

Use an lEntryField part to let the user define or view a data item. Alternatively, use 
an IMultiLineEdit part for multiple-line data. 


Building Guidelines - lEntryField 

When building with an lEntryField part, you can do the following: 

• Prime the entry field with constant initial data. Do this by specifying the initial 
value in the Text field on the lEntryField General settings page. 

• Prime the entry field with variable initial data. Do this by connecting your data 
source to the text attribute. Your application should make this connection before 
it shows the frame window. 

• Make the entry field read-only to prevent the user from entering or modifying 
text. Do this by selecting the Read only field on the lEntryField Styles settings 
page. 

• Allow the user to reach the entry field by using a tab key. Do this by setting the 
tabStop field to On on the lEntryField Styles settings page. 

• Assign information to the entry field when an event occurs, such as a push button 
being pressed. Do this with an lEntryField part and an IPushButton as follows: 

1. Connect the IPushButton buttonClickEvent feature to the lEntryField text 
attribute. 

2. Connect the data source to the text parameter of the buttonClickEvent-to-text 
connection. 
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• Copy or save the contents of the entry field when an event occurs, such as a push 
button being pressed. Do this with an IEntryField part and an IPushButton as 
follows: 

1. Connect the IPushButton buttonClickEvent feature to the data destination. 

2. Connect the IEntryField text attribute to the text parameter of the 
button ClickEvent-to-clestination connection. 


Attributes - IEntryField 

Figure 30 (Page 1 of 2). Attributes - IEntryField. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

alignment 

■ 

Alignment 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObject 

■ 

Boolean 

autoDestroy Window 

■ 

Boolean 

autoScroll 

■ 

Boolean 

autoTab 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

changed 


Boolean 

characters ize 


ISize 

charType 

■ 

CharType 

clipboardHasTextFormat 


Boolean 

command 

■ ■ 

Boolean 

cursorPosition 

■ 

unsigned long 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

displaySize 


ISize 

empty 


Boolean 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


I Windo wHandle 

hasSelectedText 


Boolean 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

insertMode 

■ ■ 

Boolean 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 
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Figure 30 (Page 2 of 2). Attributes ■ 

- lEntryField. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

leftlndex 

■ 


unsigned long 

limit 

■ 

■ 

unsigned long 

margin 

■ 


Boolean 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

readonly 



Boolean 

rect 

■ 


IRectangle 

selectedRange 



IRange 

selectedText 



IString 

selectedT extLength 



unsigned long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabS top 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 

writeable 

■ 

■ 

Boolean 


Actions - lEntryField 


Figure 31 (Page 1 of 3). Actions - lEntryField 


Action 

Parameters 

applyBidiSettings 

BidiSettings& settings 


Boolean childlnherit=tme 


Boolean refresh=\me 

capturePointer 

Boolean capture=tme 

clear 

unsigned long timestamp=0 

convertToGUIStyle 

IBitFlag& style 


Boolean extendedOnly= false 

copy 

unsigned long timestamp=0 

cut 

unsigned long timestamp=0 

disable 


disableAutoScroil 


disableAutoTab 


disableCommand 
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Figure 31 (Page 2 of 3). Actions - lEntryField 

Action 

disableDataUpdate 

disableGroup 

disablelnsertMode 

disableMargin 

disableNotification 

disableTabStop 

disableUpdate 

discard 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

paste 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

removeAll 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

selectRange 

sendEvent 


setChangedFlag 

setFocus 

setLayoutDistorted 


Parameters 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow= true 
IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 

IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


const IRange &range =IRange(0,end) 
unsigned long timestamp= 0 
unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
Boolean changeFlag=\me 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
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Figure 31 (Page 3 of 3). Actions - IEntryField 


Action 

Parameters 

show 

Boolean visible=tme 

showSourceEmphasis 

Boolean show=tme 

tryField 


Figure 32. Events - lEntryField 

Event 

Notification ID 

char acter T y peE vent 

characterTypeld 

commandEvent 

commandld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCU SFALSEID 

systemCommandEvent 

sy stemC ommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 


General Settings - lEntryField 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

Limit 

Sets the length (in bytes) of the longest text the part can hold. 

Default value: 32 

Insert mode 

Sets insert mode to on. 

Default value: Selected 
Alignment 

Changes the text alignment of the part. Left aligns the text to the left. Center 
centers the text, and Right aligns the text at the right. 

Default value: Left 

Character type 

Sets the type of a character at a given index. 

Default value: Any 
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Control Settings - lEntryField 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - lEntryField 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
unreadable 

Substitutes each character in the text with an asterisk. 

Default value: The Default radio button is selected. 
autoScroll 

Enables automatic scrolling for the part. The entry field automatically makes more 
space at the end of the line as the user enters more text. 

Default value: The default is on, and the Default radio button is selected. 

autoTab 

Generates a tab key when the part is filled by adding a character at the text limit of 
the part text. 

Default value: The default is off, and the Default radio button is selected. 
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command 

Generates a command event when the user selects the part. 

Default value: The Default radio button is selected. 

margin 

Sets the style so that a border is drawn around the entry field. 

Default value: The default is on, and the Default radio button is selected. 

readonly 

Prevents entering input into the field. 

Default value: The default is off, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
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saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - lEntryField 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 
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Default value: Not highlighted 


Color Settings - lEntryField 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Size/Position Settings - lEntryField 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - lEntryField 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 14. IFrameWindow 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM window with title bar and extensions 

IFrameWindow 

IWindow 

Visual part 

vbbase.vbb 


FrameWindow 


□ □ 


An IFrameWindow part is an application window that is a framework for 
user-interface controls. 

The user interacts with your application through the frame window. 

Use an IFrameWindow part as a primary or secondary window for your application. 
A primary window is the base window for your application. A secondary window is 
opened from the primary window or from another secondary window. 

A frame window can contain the following frame controls: 

• System menu 

• Title bar 

• Sizing buttons 

• Border 

• Menu bar 

The portion of the frame window not occupied by frame controls is called the client 
area. Your application program uses the client area for the presentation and 
gathering of application data. 

The client area is occupied and managed by a client control. Your application 
typically uses one of the following client controls: 
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• Canvas 

• Container 

• Multiple-line edit 

• Notebook 

• View port 

Your application uses these controls, or other controls within them, for most user 
interaction. 

You can also add extensions to the frame window. These frame extensions are 
generally application-specific. A frame extension can occupy one of the following 
areas: 

• The left- or right-hand side of the title bar area 

• The top or bottom of the client area 


Building Guidelines - IFrameWindow 

When building with an IFrameWindow part, you can do the following: 

• Define a title for the frame window. Do this by setting the Title text field on 
the IFrameWindow General settings page. 

Alternatively, use an ITitle part for the frame window title. If you use an ITitle 
part, you can change the frame window title after the window is created. The 
IFrameWindow Title text field has no effect if you use the ITitle part. 

• Attach a menu bar to the frame window. Do this as follows: 

1. Select an IMenu part from the parts palette and drop it on the free-form 
surface. 

2. Connect the IMenu this attribute to the IFrameWindow menu attribute. 

• Attach a tool bar frame extension to the frame window. Do this by selecting an 
IToolBar part from the parts palette and dropping it on the frame window. The 
tool bar is added at the top of the client area. 

• Attach an information area frame extension to the frame window. Do this by 
selecting an IlnfoArea part from the parts palette and dropping it on the frame 
window. The information area is added at the bottom of the client area. 

• Change the client for the frame window. For example, you might want an 
IMultiCellCanvas client instead of the ICanvas client that is initially provided. 

Do this by clicking mouse button 2 on the canvas and then selecting the Delete 
option. Then, select the multicell canvas from the parts palette and drop it on the 
client area of the frame window. 
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If you have controls on a client area canvas that you want to retain for the new 
client, move them to the free-form surface before you delete the old client. Then, 
place them on the new client after it is added. 

Give the primary frame window ownership of each modal secondary window. 

For a static secondary window, do this by connecting the primary IFrameWindow 
this attribute to the secondary IFrameWindow owner attribute. For a secondary 
window created dynamically with an IVBFactory part, do this by connecting the 
primary IFrameWindow this attribute to the IVBFactory owner attribute. 

Load data from your primary view into a secondary view. Do this by connecting 
objects in the primary view composite part to corresponding attributes of the 
secondary view composite part. The secondary view attributes are IVBVariables 
you have promoted to the interface of the composite part for the secondary view. 
These variables are connected to data fields within your secondary view 
composite part. 

Open a secondary window from a menu item or push button in the primary 
window. 

If you are opening a static secondary window, do this as follows: 

1. Connect the menu item commandEvent feature or the push button 
buttonClickEvent feature to the secondary IFrameWindow setFocus action. 

2. Connect the commandEvent feature or the buttonClickEvent feature to the 
secondary IFrameWindow show action or showModally action. 

If you are dynamically creating a composite part for a secondary view with an 
IVBFactory part, do this as follows: 

1. Connect the menu item commandEvent feature or the push button 
buttonClickEvent feature to the IVBFactory new action. 

2. Add an IVBVariable for the secondary view composite part to your primary 
view composite part. 

3. Connect the IVBFactory newEvent feature to the variable this attribute. 

4. Connect the newEvent feature to the variable show action or showModally 
action. 

5. Connect the newEvent feature to the variable setFocus action. 

Remove a window when the user presses a push button, such as OK or Cancel, 
to return from the window. 

For a static window that must be available to show again, do this by connecting 
the IPushButton buttonClickEvent feature to the IFrameWindow hide action. 

For a static window that is not to be opened again, do this by setting the Auto 
delete field on the IFrameWindow General settings page. 
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For a dynamically created window, do this by setting the Auto delete field on 
the IVBFactory General settings page. This represents the General of the 
secondary IFrameWindow part. 


Attributes - IFrameWindow 

Figure 33 (Page 1 of 2). Attributes - IFrameWindow. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

borderHeight 

■ 

unsigned long 

borderSize 

■ 

ISize 

borderWidth 

■ 

unsigned long 

characterSize 


ISize 

client 

■ 

I Window* 

clientHandle 


I Windo wHandle 

defaultOrdering 

■ 

I Window:: S iblingOrder 

defaultPushButton 


I Windo wHandle 

disabledBackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

flashing 


Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 


Boolean 

handle 


I Windo wHandle 

hiliteBackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

icon 

■ 

IPointerHandle 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

maximized 


Boolean 

maximizeRect 


IRectangle 

menu 



messageQueue 


IMessageQueueHandle 

minimized 


Boolean 

minimizeRect 


IRectangle 

minimumSize 

■ 

ISize 

modal 


Boolean 

mousePointer 

■ 

IPointerHandle 

nativeRect 


IRectangle 
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Figure 33 (Page 2 of 2). Attributes - 

■ IFrameWindow. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

nextShellRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

restoreRect 

■ 


IRectangle 

result 

■ 

■ 

unsigned long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 



Boolean 

toolBarList 

■ 


IToolBarList* 

usesDialogBackground 



Boolean 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 

willDestroyOnClose 



Boolean 


Actions - IFrameWindow 

Figure 34 (Page 1 of 3). Actions - IFrameWindow 

Action Parameters 


addExtension 


addT oWindowList 

applyBidiSettings 


beginFlashing 

capturePointer 

clientRectFor 

close 

con vertT oGUIS ty le 
disable 

disableNotification 

disableUpdate 

dismiss 

dispatchRemainingHandlers 

enable 

enableUpdate 

endFlashing 

frameRectFor 

handleException 


IWindow* newExtension 
Location location 

SeparatorType .s'£/?< 2 rator=IFrameWindow::thinLine 

BidiSettings& settings 
Boolean childlnherit=\me 
Boolean refresh=tme 

Boolean capture=tme 
IRectangle& frameRect 

IBitFlag& style 

Boolean extendedOnly=fa\se 


unsigned long result= 0 
IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tme 

IRectangle& clientRect 
IException& dispatcherException 
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Figure 34 (Page 2 of 3). Actions - IFrameWindow 

Action Parameters 


handleFor 

hide 

hideSourceEmphasis 

isAnExtension 

isLayoutDistorted 

matchForMnemonic 

maximize 

minimize 

moveSizeToClient 

notifyObservers 

notifyOwner 


positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

removeExtension 

removeF romWindowList 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

restore 

sendEvent 


setDestroyOnClose 

setExtensionSize 

setFocus 

setLayoutDistorted 

shareParentDB CSStatus 

show 


IEvent& exceptionEvent 
Style& standardControl 


IWindow* window 
unsigned long lay out Attribute 
unsigned short character 


IRectangle& clientRect 
INotificationEvent& event 
unsigned long id 
ICommandEvent:: Source 
£ 0 wrce=ICommandEvent: :unknown 
Boolean pointerDevice= false 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
IWindow* extension 
Boolean updateDisplay=tme 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
Boolean destroy=truQ 
IWindow* extension 
double widthOrHeight 

unsigned long lay out Attribute sOn 
unsigned long lay out Attribute sOff 

Boolean visible=imt 
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Figure 34 (Page 3 of 3). Actions - IFrameWindow 


Action 

Parameters 

showModally 


showSourceEmphasis 

Boolean show= tine 

start 

IWindowHandle& hwnd 

update 


useExtensionMinimumSize 

Window* extension 

ameWindow 


Figure 35. Events - IFrameWindow 


Event 

Notification ID 

activateEvent 

activateld 

closeEvent 

closeld 

commandEvent 

commandld 

deactivateEvent 

deactivateld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VT.SIBTF.TR UF.TD 


General Settings - IFrameWindow 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Title text 

Sets the title text for the part. 

Default value: The name of the part 

Border width 

Sets the screen coordinates for the width of the border of the frame window. 

Default value: 4 
Border height 

Sets the screen coordinates for the height of the border of the frame window. 

Default value: 5 
Auto delete 

Removes the specified item from the menu. 

Default value: Not selected 
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Control Settings - IFrameWindow 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IFrameWindow 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
accelerator 

Saves the current accelerator and changes to the new accelerator. 

Default value: The Default radio button is selected. 

animated 

Shows the frame window with animation when the user opens, closes, or restores 
it. 

Default value: The Default radio button is selected. 

appDBCSStatus 

Includes a DBCS status area in the frame of the frame window when displayed in a 
DBCS environment. 

Default value: The Default radio button is selected. 
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border 

Draws a border around the frame window, or sets the color of the border that 
surrounds the button window. 

Default value: The Default radio button is selected. 

dialogBackground 

Gives a frame the background color for the system dialog. 

Default value: The Default radio button is selected. 

dialogBorder 

Puts a dialog border around the frame window. 

Default value: The Default radio button is selected. 

hideButton 

Adds a hide button to the frame window. 

Default value: The Default radio button is selected. 

horizontals cr oil 

Provides a horizontal scroll bar for the part. 

Default value: The default is on, and the Default radio button is selected. 

maximizeButton 

Adds a maximize button to the frame window. 

Default value: The Default radio button is selected. 

menuBar 

Provides the frame window with a menu bar. 

Default value: The Default radio button is selected. 

minimizeButton 

Adds a minimize button to the frame window. 

Default value: The Default radio button is selected. 

noMoveWithOwner 

Disables the default behavior of automatically moving frame windows with their 
owner. 

Default value: The Default radio button is selected. 

shellPosition 

Sets the initial position of the window to a location and size dictated by the system 

shell. 

Default value: The Default radio button is selected. 
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sizingBorder 

Puts a sizing border around the frame window. 

Default value: The Default radio button is selected. 
systemMenu 

Provides a system menu in the frame window. 

Default value: The Default radio button is selected. 
systemModal 

Makes the part system-modal. 

Default value: The Default radio button is selected. 

titleBar 

Provides a title bar for the frame window. 

Default value: The Default radio button is selected. 
verticalScroll 

Provides a vertical scroll bar for the part. 

Default value: The Default radio button is selected. 

windowList 

Adds an entry for this frame window to the sytem window list. 

Default value: The Default radio button is selected. 

maximized 

Creates the frame window in the maximized state. 

Default value: The Default radio button is selected. 

minimized 

Creates the frame window in the minimized state. 

Default value: The Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
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Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IFrameWindow 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 
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Default value: Not highlighted 
Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IFrameWindow 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Shadow 

Sets the color of the frame window’s shadow 

Disabled background 

Sets the background color for disabled text 

Active 

Sets the color to be used for the frame window’s border when the frame 
window is active. 

Inactive 

Sets the color to be used for the frame window’s border when the frame 
window is inactive. 

Border 

Sets the color of the border drawn around the children of the frame window. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 
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Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - IFrameWindow 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Height 

Sets the minimum-allowable height, which is set by the user’s class. 
Default value: None (calculated at execution time) 


Font Settings - IFrameWindow 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 15. IGraphicPushButton 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM push-button control with graphic 

IGraphicPushButton 

IPushButton 

Visual part 

vbbase.vbb 



An IGraphicPushButton part is a selection button for an action or routing choice. The 
choice is identified by a graphic image on the push button. 

The user can click the push button to perform the indicated function. 

Use an IGraphicPushButton part to let the user request a function that can be 
represented graphically. 

Alternatively, to identify the choice with text, use an IPushButton. 


Building Guidelines - IGraphicPushButton 

When building with an IGraphicPushButton part, you can do the following: 

• Assign a bitmap to the graphic button. Do this by setting the DLL name and the 
Resource ID fields on the IGraphicPushButton General settings page. 

• Allow the user to reach the button by using a tab key. Do this by setting the 
tabStop field to On on the IGraphicPushButton Styles settings page. 

• If the button is the first control in a group, allow the user to use cursor keys to 
move between the button and follow controls in the group. Do this by setting the 
group field to On on the IGraphicPushButton Styles settings page. 

• Start the action represented by the button. Do this by connecting the 
IGraphicPushButton buttonClickEvent feature to the action on the target part. 

• Enable or disable the animated button when an event occurs. 

Enable the button as follows: 

1. Connect the event to the IGraphicPushButton enable action. 
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2. Open settings for the connection, press the Set parameters push button, and 
check the enabled setting. 

Disable the button by connecting the event to the IGraphicPushButton disable 
action. 


Attributes - IGraphicPushButton 


Figure 36 (Page 1 of 2). Attributes 

IGraphicPushButton. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

allowsMouseClickFocus 

■ 


Boolean 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObject 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

bitmap 

■ 


IBitmapHandle 

border 

■ 


Boolean 

borderColor 

■ 

■ 

IColor 

characterSize 



ISize 

clipboardHasTextFormat 



Boolean 

currentGraphicType 



GraphicType 

default 

■ 


Boolean 

defaultPushButton 



I Windo wHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

graphic Window 



IIconControl& 

group 

■ 


Boolean 

handle 



I Windo wHandle 

help 

■ 


Boolean 

highlighted 



Boolean 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

icon 

■ 


IPointerHandle 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

marginSize 

■ 


ISize 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 


146 


Visual Builder Parts Reference 





Actions 


Figure 36 (Page 2 of 2). Attributes - IGraphicPushButton. (S is Set, E is Event) 


Attribute 

S E 

Data type 

nativeRect 


IRectangle 

owner 

■ 

IWindow* 

parent 

■ 

IWindow* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

sizeToGraphic 

■ 

Boolean 

systemCommand 

■ ■ 

Boolean 

tabStop 

■ 

Boolean 

text 

■ ■ 

IString 

textLength 

■ 

unsigned long 

valid 


Boolean 

valueAsDouble 

■ ■ 


valueAsInt 

■ ■ 


valueAsUnsigned 

■ ■ 


visible 

■ ■ 

Boolean 

visibleRectangle 


IRectangle 

raphicPushButton 



Figure 37 ( Page 1 of 2). Actions ■ 

■ IGraphicPushButton 


Action 

Parameters 


applyBidiSettings 

BidiSettings& settings 


capturePointer 

click 

con vertT oGUIS ty le 


Boolean childlnherit= true 
Boolean refresh= true 
Boolean capture=tme 

IBitFlag& style 

Boolean extendedOnly=fa\se 


disable 

disableDefault 

disableGroup 

disableHelp 

disableMouseClickFocus 

disableNotification 

disableSizeT oGraphic 

disableSystemCommand 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tme 
IException& dispatcherException 
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Figure 37 (Page 2 of 2). Actions - IGraphicPushButton 

Action Parameters 


hide 

hideSourceEmphasis 

highlight 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

removeB order 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setFayoutDistorted 

show 

showSourceEmphasis 

unhighlight 


IEvent& exceptionEvent 


Boolean highlight= true 
unsigned long layoutAttribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml= 0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOjf 
Boolean visible= true 
Boolean show=tme 


Events - IGraphicPushButton 

Figure 38 (Page 1 of 2). Events - IGraphicPushButton 

Event Notification ID 


buttonClickEvent 

commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 


buttonClickld 

commandld 

FOCUSTRUEID 

ENABLEFALSEID 

EN AB LETRUEID 

FOCUSFALSEID 
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Figure 38 (Page 2 of 2). Events - IGraphicPushButton 

Event Notification ID 

sy stemC ommandEvent sy stemC ommandld 

visibilityDisabledEvent VISIBLEFALSEID 

visibilityEnabledEvent VISIBLETRUEID 


General Settings - IGraphicPushButton 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

DLL name 

Sets the name of the DLL file to be loaded. 

Default value: None 
Resource ID 

Sets the name of the DLL and resource identifier for the part. 

Default value: 0 


Control Settings - IGraphicPushButton 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 
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Styles Settings - IGraphicPushButton 

defaultStyle() 

Resets the part to the original default style. 

Default value: Selected 
sizeToGraphic 

Sizes the window to the size of the currently set graphic. 

Default value: The default is off, and the Default radio button is selected. 

noBorder 

Suppresses the drawing of a border. 

Default value: The Default radio button is selected. 

defaultButton 

Specifies this push button as the default push button. 

Default value: The default is on, and the Default radio button is selected. 

Help 

Enables help for the part. 

Default value: Not selected 
systemCommand 

Generates a system command event when the user selects the part. 

Default value: The default is off, and the Default radio button is selected. 

noPointerFocus 

Allows the cursor stay on a control for which information is required, rather than 
moving to the button. Buttons with this style do not set the focus to themselves 
when the user clicks on them using the mouse. This has no effect on keyboard 
interaction. 

Default value: The Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 
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clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 
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Handlers Settings - IGraphicPushButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IGraphicPushButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 
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Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - IGraphicPushButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
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value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - IGraphicPushButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 


154 Visual Builder Parts Reference 



Chapter 16. IGroupBox 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM group-box control 
IGroupBox 
ITextControl 
Visual part 
vbbase.vbb 


i-GroupBoxI- 

□ CheckBoxI 

□CheckBox? 


An IGroupBox part is a labeled rectangular box that can contain a group of related 
user-interface controls. 

The user can move through the controls in a group using the keyboard cursor keys. 
When the user moves the cursor forward from the last control in the group, the cursor 
returns to the first control in the group. 

Use an IGroupBox part to visually group a set of controls and label the group. 
Alternatively, use an IOutlineBox part if you do not want to label the group. 


Building Guidelines - IGroupBox 

When building with an IGroupBox part, you can do the following: 

• Define a set of related controls in a group box. Do this as follows: 

1. Select an IGroupBox part from the parts palette and drop it on a canvas. 

2. Resize the group box to the size you think you need by selecting it on the 
canvas and dragging a corner handle. 

3. Add the controls you want in the group box. 

If you add the group box after adding the controls you are enclosing, you must 
change the tabbing and depth order of controls on the canvas to position the 
group box ahead of the controls within it. Do this by clicking mouse button 2 
on the canvas and selecting the Tabbing And Depth Order choice. Then, press 
mouse button 2 on the group box in the Tabbing And Depth Order panel and 
drag it to a new position just before the first control it contains. 
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• Define the text label for a group box. Do this by entering the label in the Text 
field on the IGroupBox General settings page. 

• Make the controls in the group box a cursoring group that the user can reach 
with a tab key. The user can cycle through controls in a cursoring group using 
the keyboard cursor keys. 

Do this by setting the group and tabStop fields to On on the Styles settings 
page of the first control in the group box. Leave these fields set to Off for the 
rest of the controls in the group box. 

Also make sure that the first control following the group box on your canvas has 
the group field set to On. This makes the last control in the group box the end 
of the cursoring group. You can view and modify the group and tabStop 
settings of controls in the Tabbing And Depth Order panel. 


Attributes - IGroupBox 


Figure 39 (Page 1 of 2). Attributes 

IGroupBox. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

defaultPushButton 



I Windo wHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



I Windo wHandle 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 
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Figure 39 (Page 2 of 2). Attributes ■ 

- IGroupBox. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabS top 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IGroupBox 


Figure 40 (Page 1 of 2). Actions - IGroupBox 


Action 

Parameters 

applyBidiSettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh= true 

Boolean captur e=true 

con vertT oGUIS ty le 

IBitFlag& style 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly= false 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tmQ 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

IEvent& exceptionEvent 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

IWindowHandle& siblingWindow 
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Figure 40 (Page 2 of 2). Actions - IGroupBox 

Action 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 


Parameters 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2=0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
Boolean visible=tme 
Boolean show= true 


Events - IGroupBox 

Figure 41. Events - IGroupBox 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIB LETRUEID 
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General Settings - IGroupBox 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 


Control Settings - IGroupBox 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IGroupBox 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
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region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IGroupBox 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 
Default value: None 
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Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IGroupBox 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 
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RGB values 

Sets the color values for the static text. 
Default value: Red=0, Green=0, Blue=170 


Size/Position Settings - IGroupBox 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IGroupBox 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 17. IHelpWindow 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM window for online help 

IHelpWindow 

IWindow 

Nonvisual part 

vbbase.vbb 



HelpWindowl 


An IHelpWindow part is a window for presenting help information about your 
application. 

The user can open a help menu from a help menu, a help push button, or the FI 
function key. 

Use an IHelpWindow part to display help information for your application. The help 
window represents your set of help panels. You can use the help window for general 
and contextual help. 

If you have one or more help files that you want presented in a single help window 
for your application, add an IHelpWindow part in the composite part providing the 
primary view. If you have separate help for each application view, add an 
IHelpWindow part in each view. 


Building Guidelines - IHelpWindow 

When building with an IHelpWindow part, you can do the following: 

• Define a help window for an application view. Do this as follows: 

1. Drop an IHelpWindow part on the free-form surface of the composite part 
for the view. 

2. Type the names of your .hip files, separated by spaces, in the Help libraries 
field on the IHelpWindow General settings page. 

3. Type the title for your help window in the Title field on the IHelpWindow 
General settings page. 
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• Identify the frame window that the help window is currently related to. If you 
have only one frame window in your view, the help window is automatically 
related to that frame window. 

If you are using a single help window for multiple frame windows, associate each 
secondary frame window with the help window. Do this by connecting an event 
opening the secondary window to the setAssociatedWindow action of the 
IHelpWindow, passing the frame window as a parameter. 

For example, if you open a secondary window when a push button is pressed, 
connect the IPushButton buttonClickEvent feature to the IHelpWindow 
setAssociatedWindow action. Then, connect the secondary IFrameWindow this 
attribute to the buttonClickEvent-to-setAssociatedWindow connection to provide 
the frame window parameter. 

Alternatively, if you create the secondary window dynamically with an 
IVBFactory part, simply connect the IVBFactory newEvent feature to the 
IHelpWindow setAssociatedWindow action. The newEvent feature provides the 
frame window object as a parameter. 

• For each frame window and control, type the panel ID for its help in the Help 
panel id field on its Control settings page. The panel ID is the resource number 
specified with the res attribute of the help heading for the frame window or 
control. 


Attributes - IHelpWindow 


Figure 42 (Page 1 of 2). Attributes ■ 

- IHelpWindow. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroy Window 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

communicationWindow 



IWindowHandle 

contentsWindow 



I Windo wHandle 

coverPageWindow 



IWindowHandle 

defaultPushButton 



IWindowHandle 

di sabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 
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Actions 


Figure 42 (Page 2 of 2). Attributes - IHelpWindow. (S is Set, E is Event) 


Attribute 

S E 

Data type 

frameWindow 


Boolean 

group 


Boolean 

handle 


IWindowHandle 

hiliteBackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

indexWindow 


IWindowHandle 

itemProvider 

■ 

IDMItemProvider* 

layoutAdjustment 

menu 


IRectangle 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

owner 

■ 

IWindow* 

parent 

■ 

IWindow* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

searchListWindow 


IWindowHandle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

tabStop 


Boolean 

valid 


Boolean 

viewedPagesWindow 


IWindowHandle 

visible 

■ ■ 

Boolean 

visibleRectangle 


IRectangle 

slpWindow 

Figure 43 ( Page 1 of 2). Actions ■ 

- IHelpWindow 


Action 

Parameters 



addLibraries 

applyBidiSettings 

capturePointer 
con vertT oGUIS ty le 

disable 

disableNotification 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 


char* helpLibraryNames 
BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh=\me 
Boolean capture=tme 
IBitFlag& style 
Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tme 
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Figure 43 (Page 2 of 2). Actions - IHelpWindow 

Action Parameters 


handleException 

helpWindow 

hide 

hidePanellds 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledB ackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


set Active W indo w 

set Associated W indo w 

setFocus 

setHelpTable 

setLayoutDistorted 

setTitle 

setUsingHelp 

show 

showPanellds 

showSourceEmphasis 


IException& dispatcherException 
IEvent& exceptionEvent 
IWindow* window 


unsigned long layoutAttribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IFrameWindow* activeWindow 
IFrameWindow* relativeWindow- 0 
IFrameWindow* associatedWindow 

IResourceId& helpTable 
unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOjf 
char* titleText 
unsigned long panelld 
Boolean visible= true 
Boolean visibleId= true 
Boolean show= true 
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Events - IHelpWindow 

Figure 44. Events - IHelpWindow 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


General Settings - IHelpWindow 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Title 

Sets the title to appear on the title bar for the part. 

Default value: None 
Help libraries 

Sets the name of one or more compiled help (.hip) files that make up the help 
library. 

Default value: None 
Help table ID 

Sets the name of the help table. 

Default value: None 
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Chapter 18. IlconControl 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM icon control 
IlconControl 
IBitmapControl 
Visual part 
vbbase.vbb 



An IlconControl part draws an object image with a label. 

The user can access the represented object by clicking on the icon with mouse 
button 1 or by pressing the Enter key when the cursor is on the icon. 

Use an IlconControl part to display an icon representing a choice or an object. Be 
aware that an icon is not resized on either a set canvas or a multicell canvas when the 
canvas is resized. 


Building Guidelines - IlconControl 

When building with an IlconControl part, you can do the following: 

• Assign an icon to the control. Do this by setting the DLL name and Resource 
ID fields on the IlconControl General settings page. 

• Associate the icon control with an action. Do this by connecting the 
IlconControl commandEvent feature to the target action. 


Attributes - IlconControl 

Figure 45 (Page 1 of 3). Attributes - IlconControl. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ 

■ 

IColor 

alignment 

■ 


Alignment 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObject 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 
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Figure 45 (Page 2 of 3). Attributes - IlconControl. (S is Set, E is Event) 


Attribute S E Data type 


bitmap 

■ 

IBitmapHandle 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

clipboardHasTextFormat 


Boolean 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

displaySize 


ISize 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

fillBackground 

■ ■ 

Boolean 

fillColor 

■ ■ 

IColor 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

halftone 

■ ■ 

Boolean 

handle 


IWindowHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

icon 

■ 

IPointerHandle 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

limit 

■ ■ 

unsigned long 

menu 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

owner 

■ 

I Window* 

parent 

■ 

IWindow* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

strikeout 

■ ■ 

Boolean 

tabStop 

■ 

Boolean 

text 

■ ■ 

IString 

textLength 

■ 

unsigned long 

underscore 

■ ■ 

Boolean 

valid 


Boolean 

valueAsDouble 

■ ■ 


valueAsInt 

■ ■ 


valueAsUnsigned 

■ ■ 



172 


Visual Builder Parts Reference 




Figure 45 (Page 3 of 3). Attributes - IlconControl. (S is Set, E is Event) 

Attribute S E Data type 

visible ■ ■ Boolean 

visibleRectangle IRectangle 


Actions - IlconControl 

Figure 46 (Page 1 of 2). Actions - IlconControl 

Action Parameters 

applyBidiSettings BidiSettings& settings 

Boolean childlnherit=\me 
Boolean refresh=\me 

capturePointer Boolean capture=tme 

convertToGUIStyle IBitFlag& style 

Boolean extendedOnly=fa\se 

disable 

disableFillBackground 

disableGroup 

disableHalftone 

disableNotification 

disableStrikeout 

disableTabStop 

disableUnderscore 

disableUpdate 

dispatchRemainingHandlers IEvent& event 

Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=truQ 
IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameterl& parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 

resetBorderColor 
resetDisabledBackgroundColor 
resetDisabledForegroundColor 
resetFillColor 
resetFont 


enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 
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Figure 46 (Page 2 of 2). Actions - IlconControl 

Action Parameters 

resetForegroundColor 
resetHiliteBackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 
resetMinimumSize 
resetShadowColor 
sendEvent 


setFocus 

setLayoutDistorted 
show 

showSourceEmphasis 

Events - IlconControl 

Figure 47. Events - IlconControl 

Event 

commandEvent 
gotFocusEvent 
inputDisabledEvent 
inputEnabledEvent 
lostFocusEvent 
systemCommandEvent 
visibilityDisabledEvent 
visibilityEnabledEvent 

General Settings - IlconControl 

DLL name 

Sets the name of the DLL file to be loaded. 

Default value: None 
Resource Id 

Sets the resource identifier for the part. 

Default value: 0 
Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

174 Visual Builder Parts Reference 


Notification ID 

commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 

unsigned long lay out Attribute sOn 
unsigned long lay outAttribute sOff 
Boolean visible=tme 
Boolean show= true 



Limit 

Sets the length (in bytes) of the longest text the part can hold. 

Default value: 0 
Alignment 

Changes the alignment of the part. 

Default value: Upper left 
Word wrap 

Enables word wrap of text around at the end of a line. 

Default value: Not selected 


Control Settings - IlconControl 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IlconControl 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
mnemonic 

Draws the next character with mnemonic emphasis if a mnemonic prefix character 
is found. 
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Default value: The Default radio button is selected. 

fillBackground 

Erases the background, using the currently set fill color before drawing the text. 
Default value: The default is on, and the Default radio button is selected. 

halftone 

Draws the text in halftone color. 

Default value: The default is off, and the Default radio button is selected. 

strikeout 

Draws the text with overstriking. 

Default value: The default is off, and the Default radio button is selected. 

underscore 

Draws the text with underscoring. 

Default value: The default is off, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 
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clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IlconControl 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 
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Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IlconControl 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text that surrounds the part 

Fill 

Sets the color for the area of the part that is not occupied by text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the static text. 

Default value: Red=0, Green=0, Blue=170 
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Size/Position Settings - IlconControl 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IlconControl 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 19. IlnfoArea 

IBM frame extention to show user prompts 
IlnfoArea 
IStaticText 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


□ □ 


inactive 


An IlnfoArea part is a window area at the bottom of a frame window for displaying 
brief information about a selected menu choice. 

The user can read help information in the information area without opening another 
window for help. 

Use an IlnfoArea part to briefly describe menu choices or to report the successful 
completion of a selected action. 


Building Guidelines - IlnfoArea 

When building with an IlnfoArea part, you can do the following: 

• Attach an information area to a frame window. Do this by selecting an IlnfoArea 
from the parts palette and dropping it on the frame window. The information 
area is attached as a frame extension at the bottom of the frame window, beneath 
the client area. 

• Define text to appear in the information area for a menu item. Do this by 
entering text for the information area in the settings view for the IMenuItem part. 

• Define text to appear in the information area when the user has not selected a 
menu choice. Do this by entering text in the Inactive text field on the IlnfoArea 
General settings page. 
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• Define text to appear in the information area when the user selects a disabled 
menu choice. Do this by entering text in the Disabled text field on the 
IlnfoArea General settings page. 

• Define text to appear in the information area when the user selects a menu choice 
that has no information area text defined. Do this by entering text in the Missing 
text field on the IlnfoArea General settings page. 


Attributes - IlnfoArea 

Figure 48 (Page 1 of 2). Attributes - IlnfoArea. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

alignment 

■ 

Alignment 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroy Window 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidiSupported 


Boolean 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

clipboardHasTextFormat 


Boolean 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

disabledText 

■ ■ 

IString 

displaySize 


ISize 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

fillBackground 

■ ■ 

Boolean 

fillColor 

■ ■ 

IColor 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

halftone 

■ ■ 

Boolean 

handle 


I Windo wHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

inactiveText 

■ ■ 

IString 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

limit 

■ ■ 

unsigned long 

lineCount 

■ 

unsigned long 

menu 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 
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Figure 48 (Page 2 of 2). Attributes 

IlnfoArea. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

missingText 

■ 

■ 

IString 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

resourceLibrary 

■ 

■ 

IResourceLibrary& 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

strikeout 

■ 

■ 

Boolean 

stringT ableOffset 

■ 


long 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

underscore 

■ 

■ 

Boolean 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IlnfoArea 

Figure 49 (Page 1 of 2). Actions - IlnfoArea 


Action 

Parameters 

apply B idi S ettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh= true 

Boolean captur e=true 

con vertT oGUIS ty le 

IBitFlag& style 

disable 

disableFillBackground 

disableGroup 

disableHalftone 

disableNotification 

disableStrikeout 

disableTabStop 

disableUnderscore 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly=fa\se 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tmQ 
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Figure 49 (Page 2 of 2). Actions - IlnfoArea 

Action 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledB ackgroundColor 

resetDisabledForegroundColor 

resetFillColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 

start 

stop 


Parameters 

IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long layoutAttribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml= 0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
Boolean visible= true 
Boolean show=tme 
IFrameWindow* frame 
IFrameWindow* frame 
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Events - IlnfoArea 

Figure 50. Events - IlnfoArea 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


General Settings - IlnfoArea 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Inactive text 

Sets the text to appear in the information area when the user has not selected a 
menu choice. 

Default value: None 

Disabled text 

Sets the text to appear in the information area when the user selects a disabled a 
menu choice. 

Default value: None 

Missing text 

Sets the text to appear in the information area when the user selects a menu choice 
where no information area text has been defined. 

Default value: None 


Color Settings - IlnfoArea 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text that surrounds the part 
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Fill 

Sets the color for the area of the part that is not occupied by text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the static text. 

Default value: Red=0, Green=0, Blue=170 


Handlers Settings - IlnfoArea 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
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Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Font Settings - IlnfoArea 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 20. IListBox 

IBM list-box control 
IListBox 
IBaseListBox 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 



An IListBox part is a selection list for string choices. 

By default, the user can select only one choice from the list. When the user selects a 
choice, any previously selected choice is no longer selected. You can change the 
behavior of the list box to allow multiple selection. 

Use an IListBox part to provide a modifiable list of string choices for the user. Your 
application can add or remove choices from the list. 

Alternatively, for string selection from an entry field or a drop-down list, use one of 
the following IComboBox types: 

Drop-down 

Allows the user to type a choice or to select a choice from a drop-down list. 

Read-only drop-down 

Allows the user only to select a choice from a drop-down list. 

Simple 

Allows the user to type a choice or to select a choice from a list that is always 
displayed. 

You can provide only single selection with a combination box part. 

For selection of objects in a collection rather than strings, use an 
ICollectionViewComboBox part or an ICollectionViewListBox part. 
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Building Guidelines - IListBox 

When building with an IListBox part, you can do the following: 

• Define initial selection choices for the list box. Do this by entering the choices 
in the Contents field on the IListBox General settings page. 

• Allow the user to select more than one choice from the list. Do this by selecting 
the multipleSelection field on the IListBox Styles settings page. 

• Allow the user to reach the list box by using a tab key. Do this by setting the 
tabStop field to On on the IListBox Styles settings page. 

• Copy the index of the selection to a numeric connection parameter or attribute. 

Do this by connecting the IListBox selection attribute to the numeric target. 

• Add a new choice to the list box from an entry field when a push button is 
pressed. Add the choice to the end of the list. Do this as follows: 

1. Connect the IPushButton buttonClickEvent feature to the addAsLast action of 
the IListBox. 

2. Connect the IEntryField text attribute to the text parameter of the 
buttonClickEvent-to-addAsLast connection. This provides the entry field text 
as the parameter for the addAsLast action. 

• Remove the selected choice from the list box when a push button is pressed. Do 
this as follows: 

1. Connect the IPushButton buttonClickEvent feature to the remove action of 
the IListBox. 

2. Connect the IListBox selection attribute to the index parameter of the 
buttonClickEvent-to-remove connection. This provides the selection index as 
the parameter for the remove action. 


Attributes - IListBox 

Figure 51 (Page 1 of 2). Attributes - IListBox. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroy Window 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

count 



unsigned long 

defaultPushButton 



I Windo wHandle 
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Figure 51 (Page 2 of 2). Attributes 

IListBox. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

disabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

drawltem 

■ 


Boolean 

empty 



Boolean 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

extendedSelect 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

horizontalScroll 



Boolean 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumCharacters 

■ 


unsigned long 

minimumRows 

■ 


unsigned long 

minimumSize 

■ 


ISize 

multipleSelect 

■ 


Boolean 

nativeRect 



IRectangle 

noAdjustPosition 

■ 


Boolean 

numberOfSelections 



unsigned long 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

selection 



long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabS top 

■ 


Boolean 

top 

■ 


unsigned long 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 
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Actions - IListBox 


Figure 52 (Page 1 of 2). Actions - IListBox 


Action 

Parameters 

add 

unsigned long index 

addAscending 

char * const* itemList 
unsigned long count- 1 
char* text 

addAsFirst 

char* text 

addAsLast 

IResourceId& item 

addDescending 

char* text 

applyBidiSettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh^ true 

Boolean capture=tme 

convertToGUIStyle 

IBitFlag& style 

deselect 

Boolean extendedOnly= false 
unsigned long index 

deselectAll 

disable 

disableDrawItem 

disableExtendedSelect 

disableGroup 

disableMultipleSelect 

disableNoAdjustPosition 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=truQ 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

IEvent& exceptionEvent 

unsigned long lay out Attribute 

isSelected 

unsigned long index 

itemHandle 

unsigned long index 

itemText 

unsigned long index 

locateText 

char* searchString 

matchForMnemonic 

Boolean caseSensitive=true 

SearchType search-ox actMatch 
unsigned long index= first 
unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

IWindowHandle& siblingWindow 

positionBehindSiblings 

positionOnSiblings 

postEvent 

unsigned long eventld 

refresh 

IEventParameter 1 & parml=0 

IEventParameter2& parm2= 0 

IRectangle& invalidRectangle 
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Events 


Figure 52 (Page 2 of 2). Actions - IListBox 


Action 

Parameters 

releasePointer 


releasePresSpace 

IPresSpaceHandle& presentationSpaceHandle 

remove 

unsigned long index 

removeAll 


resetActiveColor 


resetB ackgroundColor 


resetBorderColor 


resetDisabledB ackgroundColor 


resetDisabledForegroundColor 


resetFont 


resetForegroundColor 


resetHiliteB ackgroundColor 


resetHiliteForegroundColor 


resetlnactiveColor 


resetMinimumSize 


resetShadowColor 


select 

unsigned long index 


Boolean select= true 

selectAll 


sendEvent 

unsigned long eventld 


IEventParameter 1 & parml= 0 


IEventParameter2& parm2= 0 

setFocus 


setltemHandle 

unsigned long index 


unsigned long handle 

setltemHeight 

unsigned long newHeight 

setltemText 

unsigned long index 


IResourceId& string 

setLayoutDistorted 

unsigned long layoutAttributesOn 


unsigned long layoutAttributesOff 

show 

Boolean visible= true 

showSourceEmphasis 

Boolean show= true 

itBox 


Figure 53. Events - IListBox 


Event 

Notification ID 

commandEvent 

commandld 

enterEvent 

enterld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCU SFALSEID 

systemCommandEvent 

sy stemC ommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 
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General Settings - IListBox 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Contents 

Sets initial items for the part. 

Default value: None 


Control Settings - IListBox 

Fly over short text 

Specifies the short text for the fly-over text control. 

Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IListBox 

defaultStyle() 

Resets the part to the original default style. 
Default value: Selected 
Draw item 

Allows the menu item to be drawn. 

Default value: Not selected 
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horizontals cr oil 

Provides a horizontal scroll bar for the part. 

Default value: The default is on, and the Default radio button is selected. 

multipleSelect 

Sets the style of the part to multiple selection mode. 

Default value: The default is off, and the Default radio button is selected. 

noAdjustPosition 

Restricts adjustment of the frame position of the part. As a result, certain aspects 
of enhanced performance by such alignment are lost. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
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saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IListBox 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 
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Default value: Not highlighted 


Color Settings - IListBox 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Size/Position Settings - IListBox 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IListBox 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 21. IMenu 

IBM menu control 
IMenu 
IWindow 
Nonvisual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


Menul 

s/ Menulteml 

MenuCascadel -► 

MenultemZ 
MenuCascade? ■+ 


An IMenu part is a list of action, routing, and settings choices related to an object. 
Depending on your use of the menu, it is implemented by one of the following parts: 

• IMenuBar 

• IPopUpMenu 

• ISubmenu 

An IMenuBar part is a menu of routing choices for objects in a window. The choices 
appear in a horizontal bar beneath the title bar. Each choice opens a pull-down 
menu. 

An IPopUpMenu part is a menu of context-sensitive choices for one or more objects. 
The choices appear in a pop-up window near the objects. 

An ISubmenu part is a list of action, routing, and settings choices in a menu opened 
from another menu. The menu is either a pull-down menu opened from a menu bar 
or a cascade menu opened from another menu. 

The user can select a choice, or menu item, to apply the choice to the object. 

Use an IMenu part to provide a list of choices related to an object. 
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Building Guidelines - IMenu 

When building with an IMenu part, you can do the following: 

• Attach the menu to one of the following: 

Target Resulting menu 

Frame window Menu bar (IMenuBar) 

Menu bar cascade choice Pull-down menu (ISubmenu) 

Cascade menu choice Cascade menu (ISubmenu) 

Any object with menu support Pop-up menu (IPopUpMenu) 

Do this by connecting the IMenu this attribute to the menu attribute of the target. 

As a shortcut for adding a pull-down menu or a cascade menu, drop an IMenu 
part on the target menu instead of on the free-form surface. In this case, the 
following happens automatically: 

- The new menu is placed on the free-form surface. 

- A cascade menu item is added to the target menu. 

- The this-to-menu connection is automatically made between the new menu 
and the cascade menu item. 


Attributes - IMenu 


Figure 54 (Page 1 of 2). Attributes ■ 

■ IMenu. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroy Window 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

defaultPushButton 



I Windo wHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 



Boolean 

handle 



I Windo wHandle 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 
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Figure 54 (Page 2 of 2). Attributes ■ 

■ IMenu. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




menuHandle 



IMenuHandle 

messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

numberOfltems 



unsigned long 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 



Boolean 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IMenu 

Figure 55 (Page 1 of 3). Actions - IMenu 


Action Parameters 


addBitmap 

unsigned long newltemld 
unsigned long bitmapResId 
unsigned long intoSubmenuId= 0 

addltem 

IMenuItem& menultem 
unsigned long intoSubmenuId= 0 

addSeparator 

unsigned long intoSubmenuId- 0 

addSubmenu 

unsigned long itemld 

addText 

unsigned long newltemld 
IResourceId& textResId 
unsigned long intoSubmenuId= 0 

applyBidiSettings 

BidiSettings& settings 

Boolean childlnherit= true 

Boolean refresh= true 

capturePointer 

Boolean captur e=true 

checkltem 

unsigned long itemld 

Boolean check= true 

convertToGUIStyle 

IBitFlag& style 

Boolean extendedOnly=fa\se 

cursor 

unsigned long itemld 
unsigned long inSubmenuId= 0 

deleteltem 

disable 

unsigned long itemld 
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Figure 55 (Page 2 of 3). Actions - IMenu 

Action 

disableltem 

disableNotification 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableltem 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isItemChecked 

isItemEnabled 

isLayoutDistorted 

itemRect 

matchForMnemonic 

menultem 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

removeConditionalCascade 

removeSubmenu 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteBackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

selectltem 

sendEvent 


setBitmap 

setConditionalCascade 


Parameters 

unsigned long itemld 

IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
unsigned long itemld 
Boolean enable= true 
Boolean enableWindow= true 
IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long itemld 
unsigned long itemld 
unsigned long layoutAttribute 
unsigned long itemld 
unsigned short character 
unsigned long itemld 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
unsigned long itemWithSubmenuId 
unsigned long itemWithSubmenuId 


unsigned long itemld 
unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2 =0 
unsigned long menultemld 
unsigned long newBitmapResId 
unsigned long itemWithSubmenuId 
unsigned long defaultltemld 
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Figure 55 (Page 3 of 3). Actions - IMenu 


Action 

Parameters 

setFocus 

setltem 

IMenuItem& menultem 

setLayoutDistorted 

unsigned long layoutAttributesOn 
unsigned long lay outAttribute sOff 

setSubmenu 

unsigned long itemld 

IResourceId& submenuResId 

setText 

unsigned long menultemld 

IResourceId& newTextResId 

show 

Boolean visible- true 

showSourceEmphasis 

Boolean show= true 

uneheekttem 

unsigned long itemld 


Events - IMenu 


Figure 56. Events - IMenu 


Event 

Notification ID 

commandEvent 

commandld 

gotFocusEvent 

FOCUSTRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 

General Settings - IMenu 


Subpart name 


Sets the name of the subpart (a part placed on a composite part). 

Default value: The 

name of the part 


Styles Settings - IMenu 


defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 
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clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Color Settings - IMenu 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 

Border 

Sets the color of the border that surrounds the part. 
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Disabled background 

Sets the background color for disabled text 

Highlighted background 

Sets the background color for selected text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Chapter 22. IMenuCascade 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IMenuCascade 
IMenuCascade 
IMenuItem 
Visual part 
vbbase.vbb 


MenuCascadel ■+■ 


An IMenuCascade part is a menu selection choice that represents a submenu. You 
can present the choice to the user as text or as a bitmap. 

The user can select a menu cascade to open a submenu. 

Use an IMenuCascade part to represent a set of closely related menu choices as a 
high-level menu choice. The closely related menu choices can then be presented in a 
submenu. This keeps menus shorter and defers detailed choices from the higher-level 
menu. 


Building Guidelines - IMenuCascade 

You can set up cascade menu items and attach submenus easily by building with 
IMenu parts. Alternatively, you can work directly with IMenuCascade parts for 
cascade menu items. 

When building with an IMenuCascade part, you can do the following: 

• Add a cascade menu item to a menu. Do this by dropping an IMenuCascade part 
on the IMenu part. 

• Assign text to the cascade menu item. Do this in the Menu item type field on 
the IMenuCascade General settings page. Select the Text setting and then enter 
the text in the Text field. If you want to establish a mnemonic for the cascade 
menu item, type a ~ before the mnemonic character. 

• Assign a bitmap to the cascade menu item. Do this in the Menu item type field 
on the IMenuCascade General settings page. Select the Graphic setting and 
then set the DLL name and Resource ID fields. 

• Associate the cascade menu item with a target submenu. Do this by connecting 
the submenu this attribute to the IMenuCascade menu attribute. This causes the 
target action to be performed when the user selects the menu item. 
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• If the cascade menu item is a choice on a menu bar, define brief help text to 
appear in the frame window information area when the user selects the menu 
choice. Do this by entering text in the Info area text field on the IMenuCascade 
General settings page. 

• Move the cascade menu item within your menu. Do this by clicking mouse 
button 2 on the item and dragging it to a new location in the menu. 


Attributes - IMenuCascade 


Figure 57. Attributes ■ 

■ IMenuCascade. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

asDebuglnfo 



IString 

asString 



IString 

bitmap 

■ 


IBitmapHandle 

checked 

■ 


Boolean 

commandType 

■ 


CommandType 

disabled 

■ 


Boolean 

drawltem 

■ 


Boolean 

framed 

■ 


Boolean 

highlighted 

■ 


Boolean 

id 



unsigned long 

index 

■ 


unsigned long 

isBitmap 



Boolean 

isText 



Boolean 

layoutType 

■ 


LayoutType 

menu 




noDismiss 

■ 


Boolean 

selectable 

■ 


Boolean 

separator 



Boolean 

submenu 



Boolean 

submenuHandle 

■ 


I Windo wHandle 

text 

■ 


IString 


Actions - IMenuCascade 

Figure 58. Actions - IMenuCascade 

Action 

con vertT oGUISty le 
setSeparator 


Parameters 

IBitFlag& style 

Boolean extendedOnly =false 
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Events - IMenuCascade 

Figure 59. Events - IMenuCascade 

Event Notification ID 

commandEvent commandld 


General Settings - IMenuCascade 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Info area text 

Specifies the text to appear in the information area for this part. 
Default value: None 

Menu item type 

Sets the type of the menu item. 

Default value: Text 
Text 

Sets the text of the menu item. 

Default value: Name of the menu item. 

DLL name 

Sets the name of the DLL for the menu item. 

Default value: None 
Resource ID 

Sets the resource identifier for the menu item. 

Default value: 0 
Conditional cascade 

Enables the conditional cascade menu behavior. 

Default value: Not selected 
Checked 

Places a check mark to the left of the menu item. 

Default value: Not selected 

Disabled 

Makes the menu item unselectable. 

Default value: Not selected 
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Framed 

Places a frame around the menu item. 

Default value: Not selected 
Highlighted 

Highlights the menu item. 

Default value: Not selected 

No dismiss upon selection 

Keeps the menu item visible after selection. 

Default value: Not selected 
Selectable 

Makes the menu item selectable. 

Default value: Not selected 
Draw item 

Allows the menu item to be drawn. 

Default value: Not selected 
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Chapter 23. IMenultem 

IBM menu item 
IMenultem 
IBase 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


v/ Menulteml 

An IMenultem part is a selection choice for a menu. You can present the choice to 
the user as text or as a bitmap. 

The user can select a choice, or menu item, to apply the choice to an object. 

Use an IMenultem part to present a menu choice related to an object. 


Building Guidelines - IMenultem 

When building with an IMenultem part, you can do the following: 

• Add a menu item to a menu. Do this by dropping an IMenultem part on the 
menu. 

• Assign text to the menu item. Do this in the Menu item type field on the 
IMenultem General settings page. Select the Text setting and then enter the text 
in the Text field. If you want to establish a mnemonic for the menu item, type a 
~ before the mnemonic character. 

• Assign a bitmap to the menu item. Do this in the Menu item type field on the 
IMenultem General settings page. Select the Graphic setting and then set the 

DLL name and Resource ID fields. 

• Associate the menu item with an action. Do this by connecting the IMenultem 
commandEvent feature to the target action. 

• If the menu item is a choice on a menu bar, define brief help text to appear in 
the frame window information area when the user selects the menu choice. Do 
this by entering text in the Info area text field on the IMenultem General 
settings page. 

• Preselect the menu item. Do this by setting the Checked field on the IMenultem 
General settings page. 
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• Make the menu item initially unavailable. Do this by setting the Disabled field 
on the IMenuItem General settings page. 

• Enable or disable the menu item when an event occurs, such as selection of 
another item. 

Disable the menu item as follows: 

1. Connect the event to the IMenuItem disabled attribute. 

2. Open settings for the connection, press the Set parameters push button, and 
check the Disabled setting. 

Enable the menu item by connecting the event to the IMenuItem disabled 
attribute with the Disabled setting not checked. 

• Move the menu item within your menu. Do this by clicking mouse button 2 on 
the item and dragging it to a new location in the menu. 


Attributes - IMenuItem 


Figure 60. Attributes ■ 

■ IMenuItem. (S is Set, E is Event) 


Attribute 

S E 

Data type 

asDebuglnfo 


IString 

asString 


IString 

bitmap 

■ 

IBitmapHandle 

checked 

■ 

Boolean 

commandType 

■ 

CommandType 

disabled 

■ 

Boolean 

drawltem 

■ 

Boolean 

framed 

■ 

Boolean 

highlighted 

■ 

Boolean 

id 


unsigned long 

index 

■ 

unsigned long 

isBitmap 


Boolean 

isText 


Boolean 

layoutType 

■ 

LayoutType 

noDismiss 

■ 

Boolean 

selectable 

■ 

Boolean 

separator 


Boolean 

submenu 


Boolean 

submenuHandle 

■ 

I Windo wHandle 

text 

■ 

IString 
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Actions - IMenultem 

Figure 61. Actions - IMenultem 

Action 

Parameters 

convertToGUIStyle 

setSeparator 

IBitFlag& style 

Boolean extendedOnly=fa\se 

Events - IMenultem 


Figure 62. Events - IMenultem 


Event 

Notification ID 

commandEvent 

commandld 


General Settings - IMenultem 


Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Info area text 

Specifies the text to appear in the information area for this part. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 

Menu item type 

Sets the type of the menu item. 

Default value: Text 
Text 

Sets the text of the menu item. 

Default value: Name of the menu item. 

DLL name 

Sets the name of the DLL for the menu item. 

Default value: None 
Resource ID 

Sets the resource identifier for the menu item. 

Default value: 0 
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Alt 

Sets the accelerator for the Alt key. 

Default value: Not selected 
Ctrl 

Sets the accelerator for the Ctrl key. 

Default value: Not selected 
Shift 

Sets the accelerator for the Shift key. 

Default value: Not selected 
Key 

Allows selection of an accelerator key. 

Default value: None 
Show text on menu 

Shows the text for the accelerator key with the menu item. 
Default value: Not selected 
Command type 

Generates a command event when the user selects the part. 
Default value: None 
Checked 

Places a check mark to the left of the menu item. 

Default value: Not selected 
Disabled 

Makes the menu item unselectable. 

Default value: Not selected 
Framed 

Places a frame around the menu item. 

Default value: Not selected 

Highlighted 

Highlights the menu item. 

Default value: Not selected 

No dismiss upon selection 

Keeps the menu item visible after selection. 

Default value: Not selected 
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Selectable 

Makes the menu item selectable. 
Default value: Not selected 
Draw item 

Allows the menu item to be drawn. 
Default value: Not selected 
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Chapter 24. IMenuSeparator 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IMenuSeparator 
IMenuSeparator 
IMenuItem 
Nonvisual part 
vbbase.vbb 


MenuCascadel ■+■ 
Menultem2 


An IMenuSeparator part is a visual separator between groups of menu choices. 

The user can recognize groups of related menu choices by noting the separators 
between the groups. 

Use an IMenuSeparator part to mark the beginning or end of a group of related menu 
choices. 


Building Guidelines - IMenuSeparator 

When building with an IMenuSeparator part, you can do the following: 

• Add a menu separator to a menu. Do this by dropping an IMenuSeparator part 
on the menu. 

• Move the menu separator within your menu. Do this by pressing mouse 
button 2 on the separator and dragging it to a new location in the menu. 


Attributes - IMenuSeparator 


Figure 63 (Page 1 of 2). Attributes 

IMenuSeparator. (S is Set, E is Event) 

Attribute 

S E 

Data type 

asDebuglnfo 


IString 

asString 


IString 

bitmap 

■ 

IBitmapHandle 

checked 

■ 

Boolean 

commandType 

■ 

CommandType 

disabled 

■ 

Boolean 

drawltem 

■ 

Boolean 

framed 

■ 

Boolean 

highlighted 

■ 

Boolean 

id 


unsigned long 

index 

■ 

unsigned long 
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Figure 63 (Page 2 of 2). Attributes - IMenuSeparator. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

isBitmap 



Boolean 

isText 



Boolean 

layoutType 

■ 


LayoutType 

noDismiss 

■ 


Boolean 

selectable 

■ 


Boolean 

separator 



Boolean 

submenu 



Boolean 

submenuHandle 

■ 


I Windo wHandle 


Actions - IMenuSeparator 


Figure 64. Actions - IMenuSeparator 


Action 

Parameters 

convertToGUIStyle 

setSeparator 

IBitFlag& style 

Boolean extendedOnly= false 

Events - IMenuSeparator 


Figure 65. Events - IMenuSeparator 

Event 

Notification ID 

commandEvent 

commandld 
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Chapter 25. IMessageBox 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM message dialog window 

IMessageBox 

IVBase 

Class interface part 
vbbase.vbb 


A 

MessageBonl 

An IMessageBox part is a window for displaying application messages to the user. 

The user can note the information or error presented in a message. If given a choice, 
the user can select an action in response to the message. 

Use an IMessageBox part to display information about activity or problems. For 
example, your application can do the following: 

• Inform the user about what a task is doing 

• Display an error message to the user 

You can add push buttons to the message box to give the user choices for responding 
to a message. 


Building Guidelines - IMessageBox 

When building with an IMessageBox part, you can do the following: 

• Provide a message box for a view. Do this by selecting an IMessageBox part 
from the parts palette and dropping it on the free-form surface. 

• Type the title for your message box in the Title field on the IMessageBox 
General settings page. 

• Identify the frame window that the message box is related to. If you have only 
one frame window in your view, the message box is automatically related to that 
frame window. 

If you want the message box for a second frame window in your view, do this by 
referencing the frame window Subpart name, which appears on its General 
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settings page. Enter the frame window subpart name, prefixed with “i,” in the 
Owner field on the IMessageBox General settings page. 

• Use the message box to report exceptions. Do this by connecting 
exceptionOccurred on any connection that could yield an exception to the 
IMessageBox showException action. 

• Use the message box to report other messages. Do this as follows: 

1. Connect an event related to the message to the IMessageBox show action. 

2. Open settings for the connection and press the Set parameters push button. 
Then, enter the message text and a message severity. The message text must 
be entered as a C++ string enclosed in quotation marks. The severity must 
be one of the following enumeration values: 

- information 

- warning 

- action 

- critical 

- catastrophic 

The IMessageBox class description in the IBM Open Class Library Reference 
provides information about these Severity enumeration values. 


Attributes - IMessageBox 

Figure 66. Attributes - IMessageBox. (S is Set, E is Event) 


Attribute 

S E Data type 

asDebuglnfo 

IString 

asString 

IString 

essageBox 


Figure 67. Actions - IMessageBox 

Action 

Parameters 

setTitle 

IResourceId& title 

show 

IResourceId& message 

showErrorlnfo 

Style& style 
unsigned long helpld= 0 

IResourceId& message 

showException 

Style& style 
unsigned long helpld=0 

IResourceId& message 


Style& style 
unsigned long helpld= 0 
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General Settings - IMessageBox 

Part name 

Sets the name of the part. 

Default value: The name of the part 

Title 

Sets the title to appear on the title bar for the part. 
Default value: None 
Owner 

Sets the window’s owner. 

Default value: None 
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Chapter 26. IMMAmpMixer 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM amplifier/mixer 
IMMAmpMixer 
IMMDevice 
Nonvisual part 
vbmm.vbb 


AmpMiner 

An IMMAmpMixer part is a sound amplification and mixing control. The 
amplifier-mixer enables audio signals to be transferred to speakers or other sound 
devices. 

The user can operate the amplifier-mixer through visual controls you provide. 
Circular sliders are well suited for visual control of an amplifier-mixer. 

Use an IMMAmpMixer part to provide standard audio control functions, such as 
volume and balance. 


Building Guidelines - IMMAmpMixer 

When building with an IMMAmpMixer part, you can do the following: 

• Define initial values for amplification and mixing settings. Do this on the 
IMMAmpMixer part settings page. The control fields are: 

- balance 

- bass 

- gain 

- pitch 

- treble 

- volume 

The field values range from 0 to 100. Generally, 0 is the minimum setting of the 
control and 100 is the maximum setting. For balance, 0 is the maximum left 
speaker setting, and 100 is the maximum right speaker setting. 
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• Provide visual access to amplification and mixing settings. Do this using circular 
sliders as dials that the user can turn to control settings. For example, provide a 
volume dial as follows: 

- Use the Add part choice on the Composition Editor Options menu to get an 
ICircularSlider part; then, drop it on a canvas. 

- Define the circular slider as a volume control with values from 0 to 100. 

- Connect the ICircularSlider value attribute to the IMMAmpMixer volume 
attribute. 

• Define the speed format for the amplifier-mixer if you do not want to use the 
system-provided format. Do this by selecting a choice for the speedFormat field 
on the IMMAmpMixer part settings page. 

• Define the time format for the amplifier-mixer if you do not want to use the 
system-provided format. Do this by selecting a choice for the timeFormat field 
on the IMMAmpMixer part settings page. 


Attributes - IMMAmpMixer 


Figure 68 (Page 1 of 2). Attributes ■ 

■ IMMAmpMixer. (S is Set, E is Event) 

Attribute 

S E 

Data type 

acquired 


Boolean 

aliasName 


IString 

asDebuglnfo 


IString 

asString 


IString 

audioEnabled 

■ 

Boolean 

balance 

■ 

unsigned long 

bass 

■ 

unsigned long 

closeOnDestroy 

■ 

Boolean 

description 


IString 

deviceld 


unsigned long 

deviceName 


IString 

deviceType 


unsigned long 

enabledForNotification 

■ 

Boolean 

gain 

■ 

unsigned long 

isOpen 


Boolean 

mode 


Mode 

monitoringEnabled 

■ 

Boolean 

pitch 

■ 

unsigned long 

prerollTime 


IMMTime 

prerollType 


PrerollType 

requiresFiles 


Boolean 

speedFormat 

■ 

IMMSpeed: :Format 

supportsAudio 


Boolean 

supportsDigitalTransfer 


Boolean 

supportsDisableEject 


Boolean 

supportsEject 


Boolean 

supportsPlay 


Boolean 
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Figure 68 (Page 2 of 2). Attributes - 

Attribute 

supportsRecord 

supportsRecordlnsertion 

supportsSave 

supportsStreaming 

supports Video 

supports V olume Adj u stment 

timeFormat 

treble 

volume 

Actions - IMMAmpMixer 

Figure 69. Actions - IMMAmpMixer 

Action 

acquire 

close 

connectedDeviceld 

deletePendingEvents 

disableAudio 


disableConnector 

disableMonitoring 

disableNotification 

enableConnector 


isConnectionSupported 

isConnectorEnabled 

notifyObservers 

open 

openOnThread 


operator = 
release 

supportsCommand 



Parameters 

ShareMode acquire= IMMDevice::shareable 

Boolean queuedForResources= false 

CallType c«//=IMMDevice::wait 

CallType c«//=IMMDevice::wait 

ConnectorType type 

CallType ca//=IMMDevice::wait 

EventType £ve/it=IMMDevice: :allEvents 

AudioChannel channel= IMMDevice: :all 

IMMMillisecondTime& over=IMMMillisecondTime ( ) 

CallType ca//=IMMDevice::wait 

ConnectorType type 

CallType c«//=IMMDevice::wait 

CallType c«//=IMMDevice::wait 

ConnectorType type 

Boolean enable= true 

CallType call= IMMDevice:: wait 

ConnectorType type 

CallT ype call= IMMDevice:: wait 

ConnectorType type 

CallType c«//=IMMDevice::wait 

INotificationId& nld 

IString& fileOrDevice=lStnng ( ) 

Boolean shareable=\mz 
CallType call= IMMDevice::wait 
IString& fileOrDevice=lString ( ) 

Boolean shareable=im& 

CallType call= IMMDevice::wait 
IStandardNotifier& aStandardNotifier 
CallType c«//=IMMDevice::wait 
IMMNotifyEvent::Command command 
CallType call= IMMDevice::wait 
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Events - IMMAmpMixer 

Figure 70. Events - IMMAmpMixer 

Event 

commandNotifyEvent 

cuePointEvent 

deviceEvent 

passDeviceEvent 

positionChangeEvent 
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Notification ID 

commandNotifyld 

cuePointld 

deviceEventld 

passDeviceld 

positionChangeld 



Chapter 27. IMMAudioCD 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM audio compact disc device 

IMMAudioCD 

IMMRemovableMedia 

Nonvisual part 

vbmm.vbb 


AudioCD 

An IMMAudioCD part is an audio compact disc (CD) player control. 

The user can operate the CD player through visual controls. You can easily provide 
button controls with the IMMPlayerPanel part. You can provide volume control for 
all audio devices with the IMMMasterAudio part. 

Use an IMMAudioCD part to provide standard audio CD player functions. 


Building Guidelines - IMMAudioCD 

When building with an IMMAudioCD part, you can do the following: 

• Define an initial volume setting. Do this by entering a value in the volume field 
on the IMMAudioCD part settings page. Values range from 0 for no volume to 
100 for the maximum volume. 

If you are providing an IMMMasterAudio part for volume control and are not 
providing visual access to the volume setting for the CD player, set the volume 
field value to 100. 

• Provide visual access to the volume setting. Do this using a circular slider as a 
volume dial: 

- Use the Add part choice on the Composition Editor Options menu to get an 
ICircularSlider part; then, drop it on a canvas. 

- Define the circular slider as a volume control with values from 0 to 100. 

- Connect the ICircularSlider value attribute to the IMMAudioCD volume 
attribute. 
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If you are providing visual volume control with an IMMMasterAudio part as well 
as with the CD player, the master audio volume setting determines the maximum 
volume produced. The player volume is the product of the master audio volume 
setting and the player volume setting. For example, if the master audio volume 
is set at 50 and the player volume is set at 80, the player volume is 40 percent of 
its potential maximum. 

• Provide visual access to CD player actions. Do this using animated buttons that 
the user can press to activate controls. For example, provide a play button as 
follows: 

- Select an IAnimatedButton part from the parts palette and drop it on a 
canvas. 

- Define the animated button as a latchable play button. Do this as follows: 

- Assign play bitmaps to the animated button. Do this by selecting the 
play bitmap identifier in the Bitmap field on the IAnimatedButton 
General settings page. 

- Give the button the appearance of remaining latched down while it is 
active. Do this by setting the latchable field on the IAnimatedButton 
Styles settings page. 

- Connect the IAnimatedButton buttonClickEvent feature to the IMMAudioCD 
play action. 

• Define the speed format for the CD player if you do not want to use the 
system-provided format. Do this by selecting a choice for the speedFormat field 
on the IMMAudioCD part settings page. 

• Define the time format for the CD player if you do not want to use the 
system-provided format. Do this by selecting a choice for the timeFormat field 
on the IMMAudioCD part settings page. 


Attributes - IMMAudioCD 


Figure 71 (Page 1 of 2). Attributes - IMMAudioCD. (S is Set, E is Event) 

Attribute S E Data type 


acquired 

aliasName 

asDebuglnfo 

asString 

audioEnabled 

autoPlayEnabled 

closeOnDestroy 

contents 

continuousPlayEnabled 

description 

deviceld 


Boolean 

IString 

IString 

IString 

Boolean 

Boolean 

Boolean 

IMMAudioCDContents 

Boolean 

IString 

unsigned long 
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Figure 71 (Page 2 of 2). Attributes ■ 

- IMMAudioCD. 

(S is Set, E is Event) 

Attribute 

S 

E 

Data type 

deviceName 



IString 

deviceType 



unsigned long 

discld 



IString 

discTitle 

■ 


IString 

enabledForNotification 

■ 


Boolean 

isOpen 



Boolean 

length 



unsigned long 

mediaPresent 



Boolean 

mode 



Mode 

number OfT racks 



unsigned long 

position 



unsigned long 

prerollTime 



IMMTime 

prerollType 



PrerollType 

profile 

■ 


IProfile 

requiresFiles 



Boolean 

speedFormat 

■ 


IMMSpeed: :Format 

supportsAudio 



Boolean 

supportsDigitalTransfer 



Boolean 

supportsDisableEject 



Boolean 

supportsEject 



Boolean 

supportsPlay 



Boolean 

supportsRecord 



Boolean 

supportsRecordlnsertion 



Boolean 

supports Save 



Boolean 

supportsStreaming 



Boolean 

supports Video 



Boolean 

supports V olume Adjustment 



Boolean 

timeFormat 

■ 


IMMT ime:: Format 

upc 



IString 

volume 

■ 


unsigned long 


Actions - IMMAudioCD 

Figure 72 (Page 1 of 3). Actions - IMMAudioCD 

Action Parameters 


acquire 


addCuePoint 

close 

closeDoor 

connectedDeviceld 

cueForPlayback 

deletePendingEvents 

disableAudio 


ShareMode acquire= IMMDevice::shareable 

Boolean queuedForResources= false 

CallType ca//=IMMDevice::wait 

IMMTime& time 

CallType ca//=IMMDevice::wait 

CallType call= IMMDevice::wait 

CallType call= IMMDevice::wait 

ConnectorType type 

CallType c«//=IMMDevice::wait 

CallType c«//=IMMDevice::wait 

EventType eve/ 2 t=IMMDevice: :allEvents 

AudioChannel channel^ IMMDevice: :all 

IMMMillisecondTime& over=IMMMillisecondTime ( ) 

CallType ca//=IMMDevice::wait 
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Figure 72 (Page 2 of 3). Actions - IMMAudioCD 

Action Parameters 


disableAutoPlay 

disableConnector 

disableContinuousPlay 

disableNotification 

enableConnector 


goToEntry 

isConnectionSupported 

isConnectorEnabled 

lockDoor 

notifyObservers 

open 


openDoor 

openOnThread 


operator = 

pause 

play 


release 

removeCuePoint 

resume 

seek 

seekToEnd 

seekToStart 

setProgram 

setTrackTitle 

startPositionTracking 

startScanningBackward 
startScanningF orward 

stepFrame 


stop 

stopPositionTracking 


ConnectorType type 
CallType ctf//=IMMDe vice:: wait 


ConnectorType type 

Boolean enable=tme 

CallType ca//=IMMDe vice:: wait 

unsigned long index 

ConnectorType type 

CallType ca//=IMMDevice::wait 

ConnectorType type 

CallType ca//=IMMDe vice:: wait 

Boolean lock =true 

CallType ca//=IMMDe vice:: wait 

INotificationId& nld 

IString& fileOrDevice=lString ( ) 

Boolean shareable=tme 

CallType c«//=IMMDevice::wait 

Boolean open =true 

CallType call= IMMDevice::wait 

IString& fileOrDevice=lStnng ( ) 

Boolean shareable=tme 

CallType ca//=IMMDe vice:: wait 

IStandardNotifier& aStandardNotifier 

CallType ca//=IMMDe vice:: wait 

IMMTime& /rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

Boolean resumeIfPaused=tmQ 

CallType ctf//=IMMDe vice:: no wait 

CallType ca//=IMMDevice::wait 

IMMTime& time 

CallType call =IMMDe vice:: wait 

Boolean resume =true 

CallType ca//=IMMDe vice:: wait 

IMMTime& to 

CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: wait 
IMMAudioCDContents& program 
IString& title 
unsigned long track 
IMMTime& timelnterval 
CallType ca//=IMMDe vice:: wait 


unsigned long frame 5=1 
Boolean forward= true 
CallType call =IMMDe vice:: wait 
CallType c«//=IMMDevice::wait 
CallType call =IMMDe vice:: wait 
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trackBackward 

trackForward 

trackTitle 

unlockDoor 


Events - IMMAudioCD 

Figure 73. Events - IMMAudioCD 

Event 

commandNotifyEvent 

cuePointEvent 

deviceEvent 

mediaLoadedEvent 

passDeviceEvent 

positionChangeEvent 

positionTimerEvent 

trackStartedEvent 


Parameters 

IMMNotifyEvent::Command command 
CallType c«//=IMMDevice::wait 
unsigned long decrement= 1 
unsigned long increment= 1 
unsigned long track 
CallType c«//=IMMDevice::wait 


Notification ID 

commandN otify Id 

cuePointld 

deviceEventld 

mediaLoadedld 

passDeviceld 

positionChangeld 

positionTimerld 

trackStartedld 
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Chapter 28. IMMCDXA 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

CDX4 

An IMMCDXA part is an extended architecture (XA) compact disc (CD) player 
control. It operates a CD-XA device, which can read a CD with interleaved audio, 
video, and standard file data. 

The user can operate the CD player through visual controls. You can easily provide 
button controls with the IMMPlayerPanel part. You can provide volume control for 
all audio devices with the IMMMasterAudio part. 

Use an IMMCDXA part to provide extended architecture CD player functions. 


IBM support for compact disc XA 

IMMCDXA 

IMMRemovableMedia 

Nonvisual part 

vbmm.vbb 


Building Guidelines - IMMCDXA 

When building with an IMMCDXA part, you can do the following: 

• Define an initial volume setting. Do this by entering a value in the volume field 
on the IMMCDXA part settings page. Values range from 0 for no volume to 
100 for the maximum volume. 

If you are providing an IMMMasterAudio part for volume control and are not 
providing visual access to the volume setting for the CD player, set the volume 
field value to 100. 

• Provide visual access to the volume setting. Do this using a circular slider as a 
volume dial: 

- Use the Add part choice on the Composition Editor Options menu to get an 
ICircularSlider part; then, drop it on a canvas. 

- Define the circular slider as a volume control with values from 0 to 100. 
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- Connect the ICircularSlider value attribute to the IMMCDXA volume 
attribute. 

If you are providing visual volume control with an IMMMasterAudio part as well 
as with the CD player, the master audio volume setting determines the maximum 
volume produced. The player volume is the product of the master audio volume 
setting and the player volume setting. For example, if the master audio volume 
is set at 50 and the player volume is set at 80, the player volume is 40 percent of 
its potential maximum. 

• Provide visual access to CD player actions. Do this using animated buttons that 
the user can press to activate controls. For example, provide a play button as 
follows: 

- Select an IAnimatedButton part from the parts palette and drop it on a 
canvas. 

- Define the animated button as a latchable play button. Do this as follows: 

- Assign play bitmaps to the animated button. Do this by selecting the 
play bitmap identifier in the Bitmap field on the IAnimatedButton 
General settings page. 

- Give the button the appearance of remaining latched down while it is 
active. Do this by setting the latchable field on the IAnimatedButton 
Styles settings page. 

- Connect the IAnimatedButton buttonClickEvent feature to the IMMCDXA 
play action. 

• Define the speed format for the CD player if you do not want to use the 
system-provided format. Do this by selecting a choice for the speedFormat field 
on the IMMCDXA part settings page. 

• Define the time format for the CD player if you do not want to use the 
system-provided format. Do this by selecting a choice for the timeFormat field 
on the IMMCDXA part settings page. 


Attributes - IMMCDXA 


Figure 74 (Page 1 of 2). Attributes - IMMCDXA. (S is Set, E is Event) 

Attribute S E Data type 


acquired 

aliasName 

asDebuglnfo 

asString 

audioEnabled 

closeOnDestroy 

description 

deviceld 


Boolean 

IString 

IString 

IString 

Boolean 

Boolean 

IString 

unsigned long 
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Figure 74 (Page 2 of 2). Attributes - IMMCDXA. (S is Set, E is Event) 

Attribute S E 

Data type 

deviceName 

IString 

deviceType 

unsigned long 

enabledForNotification ■ 

Boolean 

isOpen 

Boolean 

length 

unsigned long 

mediaPresent 

Boolean 

mode 

Mode 

position 

unsigned long 

prerollTime 

IMMTime 

prerollType 

PrerollType 

requiresFiles 

Boolean 

speedFormat ■ 

IMMSpeed: :Format 

supportsAudio 

Boolean 

supportsDigitalT ransfer 

Boolean 

supportsDisableEject 

Boolean 

supportsEject 

Boolean 

supportsPlay 

Boolean 

supportsRecord 

Boolean 

supportsRecordlnsertion 

Boolean 

supports Save 

Boolean 

supportsStreaming 

Boolean 

supports Video 

Boolean 

supports Volume Adj u stment 

Boolean 

timeFormat ■ 

IMMT ime:: Format 

upc 

IString 

volume ■ 

unsigned long 


Actions - IMMCDXA 


Figure 75 (Page 1 of 2). Actions - IMMCDXA 


Action 

Parameters 

acquire 

ShareMode acquire=IMMDevice: : shareable 

Boolean queuedForResources- false 

CallType ca//=IMMDevice::wait 

addCuePoint 

IMMTime& time 

CallType c«//=IMMDevice::wait 

close 

CallType ca//=IMMDevice::wait 

closeDoor 

CallType ca//=IMMDevice::wait 

connectedDeviceld 

ConnectorType type 

CallType ca//=IMMDevice::wait 

cueForPlayback 

CallType ca//=IMMDevice::wait 

deletePendingEvents 

EventType £ve/i?=IMMDevice: :allEvents 

disableAudio 

AudioChannel channel^ IMMDevice:: all 
IMMMillisecondTime& ov^r=IMMMillisecondTime ( ) 
CallType ca//=IMMDevice::wait 

disableConnector 

disableNotification 

ConnectorType type 

CallType ca//=IMMDevice::wait 

enableConnector 

ConnectorType type 
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Figure 75 (Page 2 of 2). Actions - 1MMCDXA 

Action Parameters 


isConnectionSupported 

isConnectorEnabled 

lockDoor 

notifyObservers 

open 

openDoor 

openOnThread 


operator = 

pause 

play 


release 

removeCuePoint 

resume 

seek 

seekToEnd 

seekToStart 

startPositionTracking 

stepFrame 


stop 

stopPositionTracking 

supportsCommand 

unlockDoor 


Boolean enable =true 

CallType ca//=IMMDevice::wait 

ConnectorType type 

CallType ca//=IMMDe vice:: wait 

ConnectorType type 

CallType ctf//=IMMDe vice:: wait 

Boolean lock =true 

CallType ca//=IMMDe vice:: wait 

INotificationId& nld 

IString& fileOrDevice=l$tnng ( ) 

Boolean shareable=tme 

CallType ca//=IMMDevice::wait 

Boolean open =true 

CallType ca//=IMMDe vice:: wait 

IString& fileOrDevice=lString ( ) 

Boolean shareable=tme 

CallType ca//=IMMDe vice:: wait 

IStandardNotifier& aStandardNotifier 

CallType ctf//=IMMDe vice:: wait 

IMMTime&/rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

Boolean resumeIfPaused =true 
CallType ctf//=IMMDe vice:: no wait 
CallType ca//=IMMDe vice:: wait 
IMMTime& time 
CallType ca//=IMMDe vice:: wait 
Boolean resume=tme 
CallType ctf//=IMMDe vice:: wait 
IMMTime& to 

CallType ctf//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: wait 
CallType c«//=IMMDevice::wait 
IMMTime& timelnterval 
CallType ca//=IMMDe vice:: wait 
unsigned long frames=\ 

Boolean forward= true 
CallType c«//=IMMDevice::wait 
CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDevice::wait 
IMMNotifyEvent:: Command command 
CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDevice::wait 
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Events - IMMCDXA 

Figure 76. Events - IMMCDXA 

Event 

commandN otify Event 

cuePointEvent 

deviceEvent 

mediaLoadedEvent 

passDeviceEvent 

positionChangeEvent 


Notification ID 

commandN otify Id 

cuePointld 

deviceEventld 

mediaLoadedld 

passDeviceld 

positionChangeld 


Chapter 28. IMMCDXA 239 



240 Visual Builder Parts Reference 



Chapter 29. IMMDigitalVideo 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM digital video 
IMMDigital V ideo 
IMMConfigurableAudio 
Nonvisual part 
vbmm.vbb 


DigitalVideo 


An IMMDigitalVideo part is a digital video player control. 

The user can operate the video player through visual controls. You can easily 
provide button controls with the IMMPlayerPanel part. You can provide volume 
control for all audio devices with the IMMMasterAudio part. 

Use an IMMDigitalVideo part to provide standard video player functions. 


Building Guidelines - IMMDigitalVideo 

When building with an IMMDigitalVideo part, you can do the following: 

• Define an initial volume setting. Do this by entering a value in the volume field 
on the IMMDigitalVideo part settings page. Values range from 0 for no volume 
to 100 for the maximum volume. 

If you are providing an IMMMasterAudio part for volume control and are not 
providing visual access to the volume setting for the video player, set the volume 
field value to 100. 

• Provide visual access to the volume setting. Do this using a circular slider as a 
volume dial: 

- Use the Add part choice on the Composition Editor Options menu to get an 
ICircularSlider part; then, drop it on a canvas. 

- Define the circular slider as a volume control with values from 0 to 100. 

- Connect the ICircularSlider value attribute to the IMMDigitalVideo volume 
attribute. 
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If you are providing visual volume control with an IMMMasterAudio part as well 
as with the video player, the master audio volume setting determines the 
maximum volume produced. The player volume is the product of the master 
audio volume setting and the player volume setting. For example, if the master 
audio volume is set at 50 and the player volume is set at 80, the player volume is 
40 percent of its potential maximum. 

• Provide visual access to video player actions. Do this using animated buttons 
that the user can press to activate controls. For example, provide a play button 
as follows: 

- Select an IAnimatedButton part from the parts palette and drop it on a 
canvas. 

- Define the animated button as a latchable play button. Do this as follows: 

- Assign play bitmaps to the animated button. Do this by selecting the 
play bitmap identifier in the Bitmap field on the IAnimatedButton 
General settings page. 

- Give the button the appearance of remaining latched down while it is 
active. Do this by setting the latchable field on the IAnimatedButton 
Styles settings page. 

- Connect the IAnimatedButton buttonClickEvent feature to the 
IMMDigitalVideo play action. 

- Define the number of audio output channels for the video player. Do this by 
entering a number in the channels field on the IMMDigitalVideo part 
settings page. Enter 1 for monophonic (mono) output or 2 for stereophonic 
(stereo) output. 

- Define the audio format for the video player. The default format is pcm. 

Do this by selecting a choice for the format field on the IMMDigitalVideo 
part settings page. 

- Define the speed format for the video player if you do not want to use the 
system-provided format. Do this by selecting a choice for the speedFormat 
field on the IMMDigitalVideo part settings page. 

- Define the time format for the video player if you do not want to use the 
system-provided format. Do this by selecting a choice for the timeFormat 
field on the IMMDigitalVideo part settings page. 
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Attributes - IMMDigitalVideo 


Figure 77 (Page 1 of 2). Attributes ■ 

- IMMDigitalVideo. 

(S is Set, E is Event) 

Attribute 

S E 

Data type 

acquired 


Boolean 

aliasName 


IString 

asDebuglnfo 


IString 

asString 


IString 

audioEnabled 

■ 

Boolean 

bitsPerS ample 

■ 

unsigned long 

blockAlignment 

■ 

unsigned long 

bytesPerSecond 

■ 

unsigned long 

canRedo 


Boolean 

canUndo 


Boolean 

channels 

■ 

unsigned long 

closeOnDestroy 

■ 

Boolean 

description 


IString 

destinationRectangle 


IRectangle 

deviceld 


unsigned long 

deviceName 


IString 

deviceType 


unsigned long 

enabledForNotification 

■ 

Boolean 

fastSpeed 


IMMSpeed 

filename 

■ 

IString 

fileNormalSpeed 


IMMSpeed 

format 

■ 

IMMAudioBuffer: iFormat 

handle 


IWindowHandle 

isOpen 


Boolean 

length 


unsigned long 

maximumSpeed 


IMMSpeed 

maximumWindows 


unsigned long 

minimumSpeed 


IMMSpeed 

mode 


Mode 

monitorHandle 


IWindowHandle 

monitoringEnabled 

■ 

Boolean 

normalSpeed 


IMMSpeed 

playingForward 


Boolean 

position 


unsigned long 

prerollTime 


IMMTime 

prerollType 


PrerollType 

readonly 


Boolean 

requiresFiles 


Boolean 

samplesPerSecond 

■ 

unsigned long 

slowSpeed 


IMMSpeed 

sourceRectangle 


IRectangle 

speed 


IMMSpeed 

speedFormat 

■ 

IMMSpeed: :Format 

supportsAudio 


Boolean 

supportsDigitalT ransfer 


Boolean 

supportsDisableEject 


Boolean 

supportsEject 


Boolean 

supportsOverlayGraphics 


Boolean 

supportsPlay 


Boolean 
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Figure 77 (Page 2 of 2). Attributes - IMMDigitalVideo. 

(S is Set, E is Event) 

Attribute S E 

Data type 

supportsRecord 

Boolean 

supportsRecordlnsertion 

Boolean 

supportsReverse 

Boolean 

supportsSave 

Boolean 

supportsSizing 

Boolean 

supportsStreaming 

Boolean 

supportsStretchToFit 

Boolean 

supports Video 

Boolean 

supports Volume Adjustment 

Boolean 

timeFormat ■ 

IMMTime: :Format 

videoFileHeight 

unsigned long 

videoFileName 

IString 

videoFileWidth 

unsigned long 

videoHeight 

unsigned long 

videoWidth 

unsigned long 

volume ■ 

unsigned long 


Actions - IMMDigitalVideo 

Figure 78 (Page 1 of 3). Actions - IMMDigitalVideo 


Action Parameters 


acquire 

ShareMode acqui re=IMMDe vice:: shareable 

addCuePoint 

Boolean queuedForResources= false 

CallType ca//=IMMDevice::wait 

IMMTime& time 

close 

CallType ca//=IMMDevice::wait 

CallType ca//=IMMDevice::wait 

connectedDeviceld 

ConnectorType type 

copy 

CallType ca//=IMMDevice::wait 
IMMTime&/rom=IMMTime ( ) 

cueForPlayback 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 

CallType ca//=IMMDevice::wait 

cueForRecording 

CallType < itll =\\1 MDevice::nowai 1 

cut 

IMMTime&/rom=IMMTime ( ) 

deletePendingEvents 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 

EventType ct'e;it=IMMDevice::allEvents 

deleteSelection 

IMMTime&/rom=IMMTime ( ) 

disableAudio 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 

AudioChannel channel= IMMDevice:: all 

disableConnector 

IMMMillisecondTime& over^IMMMillisecondTime ( ) 
CallType ca//=IMMDevice::wait 

ConnectorType type 

disableMonitoring 

CallType ca//=IMMDevice::wait 

CallType ca//=IMMDevice::wait 

disableNotification 

enableConnector 

ConnectorType type 
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Figure 78 (Page 2 of 3). Actions - IMMDigitalVideo 

Action Parameters 


isConnectionSupported 

isConnectorEnabled 

loadOnThread 

notifyObservers 

open 


openOnThread 


operator - 
paste 


pause 

play 


playAt 


play Fast 


playScan 


playSlow 


record 


redo 

refresh 


release 

removeCuePoint 

resume 


Boolean enable= true 

CallType c«//=IMMDevice::wait 

ConnectorType type 

CallType call= IMMDevice::wait 

ConnectorType type 

CallType c«//=IMMDevice::wait 

IString& filename 

Boolean readOnly= false 

INotificationId& nld 

IString& fileOrDevice=IStnng ( ) 

Boolean shareable= true 

CallType c«//=IMMDevice::wait 

IString& fileOrDevice=lStnng ( ) 

Boolean shareable= true 

CallType ca//=IMMDevice::wait 

IStandardNotifier& aStandardNotifier 

IMMTime&/rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

Boolean convert= true 
CallType c«//=IMMDevice::wait 
CallType c«//=IMMDevice::wait 
IMMTime&/rora=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

Boolean resume IfPaused=tm& 

CallType c«//=IMMDevice::nowait 
IMMSpeed& speed 
IMMTime& /rom=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

CallType c«//=IMMDevice::nowait 
IMMTime&/rom=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

CallType c«//=IMMDevice:: nowait 
IMMTime& /rora=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::nowait 
IMMTime&/rora=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::nowait 
Boolean insert- true 
IMMTime& begin= IMMTime ( ) 
IMMTime& end=lMMTime ( ) 
Boolean resumeIfPaused= true 
CallType c«//=IMMDevice::nowait 
CallType call= IMMDevice::wait 
IRectangle& source= IRectangle ( ) 
IRectangle& destination= IRectangle ( ) 
CallType call= IMMDevice::wait 
CallType ca//=IMMDevice::wait 
IMMTime& time 
CallType call= IMMDevice::wait 
Boolean resume=tm& 
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Figure 78 (Page 3 of 3). Actions -1 A 

Action 

save 

saveAs 

seek 

seekToEnd 

seekToStart 

setDestination 

setMonitorWindow 

setWindow 

startPositionTracking 

stepFrame 

stop 

stopPositionTracking 

supportsCommand 

undo 

useDefaultMonitorWindow 

useDefaultWindow 

Events - IMMDigitalVideo 

Figure 79. Events - IMMDigitalVideo 

Event 

commandN otifyE vent 

cuePointEvent 

deviceEvent 

passDeviceEvent 

positionChangeEvent 
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CallType ca//=IMMDevice::wait 
CallType call=l MMDevice::nowait 
IString& filename 
CallType ca//=IMMDevice::nowait 
IMMTime& to 

CallType ca//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 
IRectangle& rectangle 
CallType =IMMDevice::wait 
IWindow& window 
CallType ca//=IMMDevice::wait 
IWindowHandle& handle 
CallType ca//=IMMDevice::wait 
IMMTime& timelnterval 
CallType ca//=IMMDevice::wait 
unsigned long fra?nes=l 
Boolean forward= true 
CallType ca//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 
IMMNotifyEvent::Command command 
CallType ca//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 


Notification ID 

commandNotifyld 

cuePointld 

deviceEventld 

passDeviceld 

positionChangeld 





Chapter 30. IMMMasterAudio 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM master audio 
IMMMasterAudio 
IStandardNotifier 
Nonvisual part 
vbmm.vbb 


MasterAudio 


An IMMMasterAudio part is a master volume and sound device control. 

The user can operate the master volume through a visual control you provide. A 
circular slider is well suited for visual control of volume. 

Use an IMMMasterAudio part to provide a master volume control. Your application 
can also use the control to enable and disable speakers and headphones. Be aware 
that a master audio control affects all sound output for the system. 


Building Guidelines - IMMMasterAudio 

When building with an IMMMasterAudio part, you can do the following: 

• Define an initial volume setting. Do this by entering a value in the volume field 
on the IMMMasterAudio part settings page. Values range from 0 for no volume 
to 100 for the maximum volume. 

• Provide visual access to the volume setting. Do this using a circular slider as a 
volume dial: 

- Use the Add part choice on the Composition Editor Options menu to get an 
ICircularSlider part; then, drop it on a canvas. 

- Define the circular slider as a volume control with values from 0 to 100. 

- Connect the ICircularSlider value attribute to the IMMMasterAudio volume 
attribute. 

• Provide visual access to master audio actions. Do this using animated buttons 
that the user can press to activate controls. For example, provide a mute button 
as follows: 
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- Select an IAnimatedButton part from the parts palette and drop it on a 
canvas. 

- Define the animated button as a latchable mute button. Do this as follows: 

- Assign play bitmaps to the animated button. Do this by selecting the 
mute bitmap identifier in the Bitmap field on the IAnimatedButton 
General settings page. 

- Give the button the appearance of remaining latched down while it is 
active. Do this by setting the latchable field on the IAnimatedButton 
Styles settings page. 

- Connect the IAnimatedButton buttonClickEvent feature to IMMMasterAudio 
Custom logic. Enter C++ code to mute and unmute the sound. 

For example, you could enter the following code: 

unsigned long volumeBeforeMute = 50; // Set an initial previous volume 

if (target->volume() == 0) // Turn sound on if it is off 

{ 

target->setVolume(volumeBeforeMute); 

} 

else // Turn sound off if it is on 

{ 

volumeBeforeMute = target->volume(); 
target->setVolume(O); 

} 


Attributes - IMMMasterAudio 


Figure 80. Attributes - IMMMasterAudio. (S is Set, E is Event) 

Attribute S E Data type 


areHeadphonesEnabled 

areSpeakersEnabled 

asDebuglnfo 

asString 

enabledForNotification 

volume 


Boolean 

Boolean 

IString 

IString 

Boolean 

unsigned long 


Actions - IMMMasterAudio 

Figure 81 (Page 1 of 2). Actions - IMMMasterAudio 

Action Parameters 


disableHeadphones 

disableNotification 

disableSpeakers 

enableHeadphones 

enableSpeakers 


IMMDevice: :CallType ca//=IMMDevice: :wait 

IMMDevice: :CallType cfl//=IMMDevice: :wait 
Boolean enable= true 

IMMDevice: :CallType ca//=IMMDevice: iwait 
Boolean enable= true 


248 


Visual Builder Parts Reference 



Figure 81 (Page 2 of 2). Actions - IMMMasterAudio 

Action Parameters 


notifyObservers 
operator = 

saveHeadphonesSetting 
saveSpeakersSetting 
save Volume 


IMMDevice: :CallType ca//=IMMDevice::wait 
INotificationId& nld 
IStandardNotifier& aStandardNotifier 
IMMDevice: :CallType ca//=IMMDevice::wait 
IMMDevice::CallType ca//=IMMDevice::wait 
IMMDevice: :CallType ca//=IMMDevice::wait 


Chapter 30. IMMMasterAudio 249 



250 Visual Builder Parts Reference 



Chapter 31. IMMPlayerPanel 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM player panel 
IMMPlayerPanel 
IMultiCellCanvas 
Visual part 
vbmm.vbb 


mjsrm 


11 


An IMMPlayerPanel part is a multimedia device control panel. 

The user can operate an audio or video player through visual controls in the player 
panel. 

Use an IMMPlayerPanel part for easy composition and control of audio and video 
players. 


Building Guidelines - IMMPlayerPanel 

When building with an IMMPlayerPanel part, you can do the following: 

• Associate the player panel with a device. Do this by identifying the device as the 
playable device for the panel. 

For example, to use the player panel with an audio CD player, connect the 
IMMAudioCD this attribute to the IMMPlayerPanel playableDevice attribute. 

Buttons in the player panel are automatically connected to corresponding actions 
in the associated player. For example, the play button is automatically connected 
to the play action of the player part. 

The IMMPlayerPanel part also provides automatic disablement and enablement of 
buttons when related buttons are pressed. For example, if the player is stopped, 
the stop and pause buttons are disabled. As another example, if the pause button 
is pressed while the device is playing, the pause button is latched down and the 
play button is unlatched. 
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Attributes - IMMPlayerPanel 

Figure 82 (Page 1 of 2). Attributes - IMMPlayerPanel. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroy Window 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

defaultCell 

■ 

ISize 

defaultPushButton 


I Windo wHandle 

deviceType 


unsigned long 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

dragLines 

■ 

Boolean 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

fastF orwardButton 


I AnimatedB utton * 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

gridLines 

■ 

Boolean 

group 

■ 

Boolean 

handle 


I Windo wHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 

menu 


IRectangle 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

origDefaultB uttonHandle 


IWindo wHandle 

owner 

■ 

I Window* 

parent 

■ 

I Window* 

parentSize 


ISize 

pauseButton 


I AnimatedB utton * 

playableDevice 

■ 

IMMPlayableDevice* 

playButton 


I AnimatedB utton * 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

rewindButton 


I AnimatedB utton * 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 
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Figure 82 (Page 2 of 2). Attributes 

- IMMPlayerPanel. 

(S is Set, E is Event) 

Attribute 

S 

E Data type 

size 

■ 

■ ISize 

stepBackwardButton 


I Ani matedB utton * 

stepF orwardButton 


IAnimatedButton* 

stopButton 


I AnimatedB utton * 

tabStop 

■ 

Boolean 

valid 


Boolean 

visible 

■ 

■ Boolean 

visibleRectangle 


IRectangle 

Actions - IMMPlayerPanel 



Figure 83 (Page 1 of 2). Actions- 

IMMPlayerPanel 



Action Parameters 

addToCell Window* childWindow 


unsigned long startingColumn 
unsigned long startingRow 
unsigned long numberOfColumns=\ 
unsigned long numberOfRows=\ 


applyBidiSettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh= true 

Boolean capture=tme 

columnWidth 

unsigned long column 

con vertT oGUIS ty le 

IBitFlag& style 

disable 

disableDragLines 

disableGridLines 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly=fdlsQ 

IEvent& event 

enable 

Boolean callDefProc= true 
Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tme 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isColumnExpandable 

IEvent& exceptionEvent 

unsigned long column 

isLayoutDistorted 

unsigned long lay out Attribute 

isRowExpandable 

unsigned long row 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

IWindowHandle& siblingWindow 

positionBehindSiblings 

positionOnSiblings 

postEvent 

unsigned long eventld 
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Figure 83 (Page 2 of 2). Actions - IMMPlayerPanel 

Action Parameters 


refresh 

releasePointer 

releasePresSpace 

removeFromCell 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteBackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

rowHeight 

sendEvent 


setColumn W idth 


setFocus 

setLayoutDistorted 

setRowHeight 


show 

showSourceEmphasis 

windowInCell 


IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
unsigned long column 
unsigned long row 


unsigned long row 
unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2=0 
unsigned long column 
unsigned long widthlnPixels 
Boolean expandable= false 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOjf 
unsigned long row 
unsigned long heightlnPixels 
Boolean expandable= false 
Boolean visible=tme 
Boolean show= true 
unsigned long startingColumn 
unsigned long startingRow 


Events - IMMPlayerPanel 

Figure 84. Events - IMMPlayerPanel 

Event Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 
FOCUSTRUEID 
ENABLEFALSEID 
EN AB LETRUEID 
FOCUSFALSEID 
systemCommandld 
VISIBLEFALSEID 
VISIB LETRUEID 
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General Settings - IMMPlayerPanel 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 


Control Settings - IMMPlayerPanel 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 

Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IMMPlayerPanel 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 
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clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IMMPlayerPanel 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 
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Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IMMPlayerPanel 

Color area 

Sets the color of the given area. Choices are as follows: 

Background 

Sets the color for background text 

Default value: Background is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the canvas. 

Default value: Red=255, Green=255, Blue=255 
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Size/Position Settings - IMMPlayerPanel 

X field 

Sets the X coordinate of the part if it is not the client part. 

Default value: Not available 
Y field 

Sets the Y coordinate of the part if it is not the client part. 

Default value: Not available 

Width 

Sets the width of the canvas, if it is not the client part. 

Default value: Not available 
Height 

Sets the height of the canvas, if it is not the client part. 

Default value: Not available 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Chapter 32. IMMSequencer 

Title: IBM sequencer 

Class name: IMMSequencer 

Base part: IMMFileMedia 

Part type: Nonvisual part 

Part file: vbmm.vbb 

Sequencer 

An IMMSequencer part is a Musical Instrument Digital Interface (MIDI) file audio 
player control. 

The user can operate the sequencer through visual controls. You can easily provide 
button controls with the IMMPlayerPanel part. You can provide volume control for 
all audio devices with the IMMMasterAudio part. 

Use an IMMSequencer part to provide standard audio player functions for MIDI files. 

Building Guidelines - IMMSequencer 

When building with an IMMSequencer part, you can do the following: 

• Define an initial volume setting. Do this by entering a value in the volume field 
on the IMMSequencer part settings page. Values range from 0 for no volume to 
100 for the maximum volume. 

If you are providing an IMMMasterAudio part for volume control and are not 
providing visual access to the volume setting for the sequencer, set the volume 
field value to 100. 

• Provide visual access to the volume setting. Do this using a circular slider as a 
volume dial: 

- Use the Add part choice on the Composition Editor Options menu to get an 
ICircularSlider part; then, drop it on a canvas. 

- Define the circular slider as a volume control with values from 0 to 100. 

- Connect the ICircularSlider value attribute to the IMMSequencer volume 
attribute. 
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If you are providing visual volume control with an IMMMasterAudio part as well 
as with the sequencer, the master audio volume setting determines the maximum 
volume produced. The player volume is the product of the master audio volume 
setting and the player volume setting. For example, if the master audio volume 
is set at 50 and the player volume is set at 80, the player volume is 40 percent of 
its potential maximum. 

• Provide visual access to sequencer actions. Do this using animated buttons that 
the user can press to activate controls. For example, provide a play button as 
follows: 

- Select an IAnimatedButton part from the parts palette and drop it on a 
canvas. 

- Define the animated button as a latchable play button. Do this as follows: 

- Assign play bitmaps to the animated button. Do this by selecting the 
play bitmap identifier in the Bitmap field on the IAnimatedButton 
General settings page. 

- Give the button the appearance of remaining latched down while it is 
active. Do this by setting the latchable field on the IAnimatedButton 
Styles settings page. 

- Connect the IAnimatedButton buttonClickEvent feature to the IMMSequencer 
play action. 

• Define the speed format for the sequencer if you do not want to use the 
system-provided format. Do this by selecting a choice for the speedFormat field 
on the IMMSequencer part settings page. 

• Define the time format for the sequencer if you do not want to use the 
system-provided format. Do this by selecting a choice for the timeFormat field 
on the IMMSequencer part settings page. 


Attributes - IMMSequencer 

Figure 85 (Page 1 of 2). Attributes - IMMSequencer. (S is Set, E is Event) 


Attribute S E Data type 


acquired 


Boolean 

aliasName 


IString 

asDebuglnfo 


IString 

asString 


IString 

audioEnabled 

■ 

Boolean 

closeOnDestroy 

■ 

Boolean 

description 


IString 

deviceld 


unsigned long 

deviceName 


IString 

deviceType 


unsigned long 

enabledForNotification 

■ 

Boolean 
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Figure 85 (Page 2 of 2). Attributes - IMMSequencer. 

(S is Set, E is Event) 

Attribute S 

E 

Data type 

filename ■ 


IString 

isOpen 


Boolean 

length 


unsigned long 

mode 


Mode 

position 


unsigned long 

prerollTime 


IMMTime 

prerollType 


PrerollType 

readonly 


Boolean 

requiresFiles 


Boolean 

speedFormat ■ 


IMMSpeed: :Format 

supportsAudio 


Boolean 

supportsDigitalTransfer 


Boolean 

supportsDisableEject 


Boolean 

supportsEject 


Boolean 

supportsPlay 


Boolean 

supportsRecord 


Boolean 

supportsRecordlnsertion 


Boolean 

supports Save 


Boolean 

supportsStreaming 


Boolean 

supports Video 


Boolean 

supports V olume Adj u stment 


Boolean 

timeFormat ■ 


IMMT ime:: Format 

volume ■ 


unsigned long 


Actions - IMMSequencer 

Figure 86 (Page 1 of 2). Actions - IMMSequencer 


Action Parameters 


acquire 

ShareMode acquire=IMMDevice: shareable 

Boolean queuedForResources— false 

CallType call= IMMDevice::wait 

addCuePoint 

IMMTime& time 

CallType c«//=IMMDevice::wait 

close 

CallType c«//=IMMDevice::wait 

connectedDeviceld 

ConnectorType type 

CallType call= IMMDevice::wait 

cueForPlayback 

CallType co//=IMMDevice::wait 

deletePendingEvents 

EventType event=lMMDe\ice: :allEvents 

disableAudio 

AudioChannel channel= IMMDevice: :all 
IMMMillisecondTime& 0 ver=IMMMillisecondTime ( ) 
CallType c«//=IMMDevice::wait 

disableConnector 

disableNotification 

ConnectorType type 

CallType ca//=IMMDevice::wait 

enableConnector 

ConnectorType type 

Boolean enable=tme 

CallType ca//=IMMDevice::wait 

isConnectionSupported 

ConnectorType type 

CallType ca//=IMMDevice::wait 
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Figure 86 (Page 2 of 2). Actions - IMMSequencer 

Action Parameters 


isConnectorEnabled 

loadOnThread 

notifyObservers 

open 

openOnThread 


operator = 

pause 

play 


release 

removeCuePoint 

resume 

seek 

seekToEnd 

seekToStart 

startPositionTracking 

stepFrame 


stop 

stopPositionTracking 

supportsCommand 


ConnectorType type 
CallType ca//=IMMDevice::wait 
IString& filename 
Boolean readOnly= false 
INotificationId& nld 
IString& fileOrDevice=\Stnng ( ) 
Boolean shareable=\mo 
CallType ca//=IMMDe vice:: wait 
IString& fileOrDevice=lStnng ( ) 
Boolean shareable=tme 
CallType call= IMMDevice::wait 
IStandardNotifier& aStandardNotifier 
CallType ca//=IMMDe vice:: wait 
IMMTime& /rora=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

Boolean resumelfPaused- true 
CallType ca//=IMMDe vice:: no wait 
CallType ca//=IMMDe vice:: wait 
IMMTime& time 
CallType call= IMMDe vice:: wait 
Boolean resume=tme 
CallType ca//=IMMDe vice:: wait 
IMMTime& to 

CallType ctf//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: wait 
IMMTime& timelnterval 
CallType ca//=IMMDe vice:: wait 
unsigned long frames=l 
Boolean forward= true 
CallType ca//=IMMDevice::wait 
CallType ctf//=IMMDe vice:: wait 
CallType ca//=IMMDevice::wait 
IMMNotifyEvent:: Command command 
CallType ca//=IMMDe vice:: wait 


Events - IMMSequencer 

Figure 87. Events - IMMSequencer 

Event Notification ID 


commandNotifyEvent 

cuePointEvent 

deviceEvent 

passDeviceEvent 

positionChangeEvent 


commandN otify Id 

cuePointld 

deviceEventld 

passDeviceld 

positionChangeld 
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Chapter 33. IMMWaveAudio 

Title: IBM wave audio 

Class name: IMMWaveAudio 

Base part: IMMConfigurableAudio 

Part type: Nonvisual part 

Part file: vbmm.vbb 

WaveAudio 

An IMMWaveAudio part is a waveform file audio player and recorder control. 

The user can operate the sequencer through visual controls. You can easily provide 
button controls with the IMMPlayerPanel part. You can provide volume control for 
all audio devices with the IMMMasterAudio part. 

Use an IMMWaveAudio part to provide standard audio player functions for waveform 
files. 

Building Guidelines - IMMWaveAudio 

When building with an IMMWaveAudio part, you can do the following: 

• Define an initial volume setting. Do this by entering a value in the volume field 
on the IMMWaveAudio part settings page. Values range from 0 for no volume 
to 100 for the maximum volume. 

If you are providing an IMMMasterAudio part for volume control and are not 
providing visual access to the volume setting for the waveform player, set the 
volume field value to 100. 

• Provide visual access to the volume setting. Do this using a circular slider as a 
volume dial: 

- Use the Add part choice on the Composition Editor Options menu to get an 
ICircularSlider part; then, drop it on a canvas. 

- Define the circular slider as a volume control with values from 0 to 100. 

- Connect the ICircularSlider value attribute to the IMMWaveAudio volume 
attribute. 
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If you are providing visual volume control with an IMMMasterAudio part as well 
as with the waveform player, the master audio volume setting determines the 
maximum volume produced. The player volume is the product of the master 
audio volume setting and the player volume setting. For example, if the master 
audio volume is set at 50 and the player volume is set at 80, the player volume is 
40 percent of its potential maximum. 

• Provide visual access to waveform player actions. Do this using animated 
buttons that the user can press to activate controls. For example, provide a play 
button as follows: 

- Select an IAnimatedButton part from the parts palette and drop it on a 
canvas. 

- Define the animated button as a latchable play button. Do this as follows: 

- Assign play bitmaps to the animated button. Do this by selecting the 
play bitmap identifier in the Bitmap field on the IAnimatedButton 
General settings page. 

- Give the button the appearance of remaining latched down while it is 
active. Do this by setting the latchable field on the IAnimatedButton 
Styles settings page. 

- Connect the IAnimatedButton buttonClickEvent feature to the 
IMMWaveAudio play action. 

• Define the number of audio output channels for the waveform player. Do this by 
entering a number in the channels field on the IMMWaveAudio part settings 
page. Enter 1 for monophonic (mono) output or 2 for stereophonic (stereo) 
output. 

• Define the audio format for the waveform player. The default format is pcm. 

Do this by selecting a choice for the format field on the IMMWaveAudio part 
settings page. 

• Define the speed format for the waveform player if you do not want to use the 
system-provided format. Do this by selecting a choice for the speedFormat field 
on the IMMWaveAudio part settings page. 

• Define the time format for the waveform player if you do not want to use the 
system-provided format. Do this by selecting a choice for the timeFormat field 
on the IMMWaveAudio part settings page. 
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Attributes - IMMWaveAudio 


Figure 88. Attributes - IMMWaveAudio. 

(S is Set, E is Event) 


Attribute 

s 

E 

Data type 

acquired 



Boolean 

aliasName 



IString 

asDebuglnfo 



IString 

asString 



IString 

audioEnabled 

■ 


Boolean 

bitsPerS ample 

■ 


unsigned long 

blockAlignment 

■ 


unsigned long 

bytesPerSecond 

■ 


unsigned long 

canRedo 



Boolean 

canUndo 



Boolean 

channels 

■ 


unsigned long 

closeOnDestroy 

■ 


Boolean 

cutCopyBufferSize 



unsigned long 

description 



IString 

deviceld 



unsigned long 

deviceName 



IString 

deviceType 



unsigned long 

enabledForNotification 

■ 


Boolean 

filename 

■ 


IString 

format 

■ 


IMMAudioBuffer: iFormat 

isOpen 



Boolean 

length 



unsigned long 

mode 



Mode 

position 



unsigned long 

prerollTime 



IMMTime 

prerollType 



PrerollType 

readonly 



Boolean 

requiresFiles 



Boolean 

samplesPerSecond 

■ 


unsigned long 

speedFormat 

■ 


IMMSpeed: :Format 

supportsAudio 



Boolean 

supportsDigitalTransfer 



Boolean 

supportsDisableEject 



Boolean 

supportsEject 



Boolean 

supportsPlay 



Boolean 

supportsRecord 



Boolean 

supportsRecordlnsertion 



Boolean 

supports Save 



Boolean 

supportsStreaming 



Boolean 

supports Video 



Boolean 

supports Volume Adj u stment 



Boolean 

timeFormat 

■ 


IMMT ime:: Format 

volume 

■ 


unsigned long 
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Actions - IMMWaveAudio 

Figure 89 (Page 1 of 3). Actions - IMMWaveAudio 

Action Parameters 


acquire 

addCuePoint 

close 

connectedDeviceld 

copy 

copyF romBuffer 
copyToBuffer 


cueForPlayback 

cueForRecording 

cut 


cutToBuffer 


deletePendingEvents 

deleteSelection 


disableAudio 


disableConnector 

disableNotification 

enableConnector 


isConnectionSupported 

isConnectorEnabled 

loadOnThread 

notifyObservers 

open 


ShareMode acquire=IMMDevice: : shareable 
Boolean queuedForResources= false 
CallType ctf//=IMMDe vice:: wait 
IMMTime& time 
CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: wait 
ConnectorType type 
CallType ca//=IMMDe vice:: wait 
IMMTime&/rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ctf//=IMMDe vice:: wait 
IMMAudioBuffer& audioBuffer 
CallType ca//=IMMDevice::wait 
IMMAudioBuffer& audioBuffer 
IMMTime&/rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: wait 
CallType ca//=IMMDe vice:: no wait 
IMMTime& /rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType c«//=IMMDevice::wait 
IMMAudioBuffer& audioBuffer 
IMMTime& /rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDe vice:: wait 
EventType £ venr=IMMDe vice:: allEvents 
IMMTime&/rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDe vice:: wait 

AudioChannel channel^ IMMDevice:: all 

IMMMillisecondTime& over=IMMMillisecondTime ( ) 

CallType ca//=IMMDevice::wait 

ConnectorType type 

CallType ca//=IMMDe vice:: wait 

ConnectorType type 

Boolean enable= true 

CallType ca//=IMMDe vice:: wait 

ConnectorType type 

CallType ctf//=IMMDe vice:: wait 

ConnectorType type 

CallType c«//=IMMDevice::wait 

IString& filename 

Boolean readOnly= false 

INotificationId& nld 

IString& fileOrDevice=lString ( ) 

Boolean shareable=tme 
CallType ca//=IMMDe vice:: wait 
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Figure 89 (Page 2 of 3). Actions - IMMWaveAudio 

Action Parameters 


openOnThread 


operator = 
paste 


pasteF romBuffer 


pasteToBuffer 

pause 

play 


record 


redo 

release 

removeCuePoint 

resume 

save 

saveAs 

seek 

seekToEnd 

seekToStart 

startPositionTracking 

stepFrame 


stop 

stopPositionTracking 

supportsCommand 

supportsWaveFormat 


IString& fileOrDevice=IStnng ( ) 
Boolean shareable= true 
CallType c«//=IMMDevice::wait 
IStandardNotifier& aStandardNotifier 
IMMTime&/rom=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

Boolean convert- true 
CallType ca//=IMMDevice::wait 
IMMAudioBuffer& audioBuffer 
IMMTime& /ram=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

CallType c«//=IMMDevice::wait 
IMMAudioBuffer& audioBuffer 
CallType c«//=IMMDevice::wait 
CallType c«//=IMMDevice::wait 
IMMTime&/ram=IMMTime ( ) 
IMMTime& fo=IMMTime ( ) 

Boolean resumeIfPaused=lmQ 
CallType call=lMMDe vice:: nowait 
Boolean insert- true 
IMMTime& begin= IMMTime ( ) 
IMMTime& end= IMMTime ( ) 
Boolean resumeIfPaused=lmQ 
CallType ca//=IMMDevice::nowait 
CallType call= IMMDevice::wait 
CallType call= IMMDevice::wait 
IMMTime& time 
CallType call= IMMDevice::wait 
Boolean resume= true 
CallType c«//=IMMDevice::wait 
CallType c«//=IMMDevice::nowait 
IString& filename 
CallT ype call= IMMDe vice:: nowait 
IMMTime& to 

CallType call= IMMDevice::wait 
CallType call= IMMDevice::wait 
CallType call= IMMDevice::wait 
IMMTime& timelnterval 
CallType c«//=IMMDevice::wait 
unsigned long frames=l 
Boolean forward= true 
CallType c«//=IMMDevice::wait 
CallType c«//=IMMDevice::wait 
CallType ca//=IMMDevice::wait 
IMMNotifyEvent::Command command 
CallType call= IMMDevice::wait 
unsigned long bitsPerSample 
unsigned long samplesPerSecond 
unsigned long channels 
IMMAudioBuffer::Format format 
CallType co//=IMMDevice::wait 
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Figure 89 (Page 3 of 3). Actions -1 

Action 

undo 

Events - IMMWaveAudio 

Figure 90. Events - IMMWaveAudio 

Event 

commandNotifyEvent 

cuePointEvent 

deviceEvent 

passDeviceEvent 

positionChangeEvent 
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Notification ID 

commandNotifyld 

cuePointld 

deviceEventld 

passDeviceld 

positionChangeld 





Chapter 34. IMultiCellCanvas 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM resizable multicell canvas 

IMultiCellCanvas 

ICanvas 

Visual part 

vbbase.vbb 


An IMultiCellCanvas part is a set of cells in rows and columns that can contain 
controls spanning rows and columns. This provides flexibility in arranging controls 
on the canvas. 

The user interacts with controls placed on the canvas, not with the canvas itself. 

Use an IMultiCellCanvas part to provide freely arranged canvas cells within a 
framework, such as one of the following: 

• The client area of a frame window 

• A view port 

• A multicell canvas cell 

• A split canvas pane 

• A notebook page 

You can then place other controls within the cells of the multicell canvas. 

You can also use a multicell canvas as the base part for a composite part. Then, you 
can add the canvas with its controls as a subpart on a canvas in another composite 
part. 

The cells in a multicell canvas are adjusted for varying control text length. This 
enhances national language support. If you build the multicell canvas with some 
expandable rows and columns, controls in the cells remain uniformly spaced when the 
user resizes the canvas. 
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Alternatively, use one of the following canvases: 

• ICanvas for a single canvas cell 

• ISplitCanvas for split windows 

• ISetCanvas for canvas cells in uniform rows or columns 


Building Guidelines - IMultiCellCanvas 

When building with an IMultiCellCanvas part, you can do the following: 

• Place controls in the multicell canvas. Do this by dropping controls in the cells 
where they are to begin. The cell is sized to accommodate the largest minimum 
size of controls in the row and column. 

Do not place controls in the first row and the first column. Reserve them as left 
and top margins. 

If you drop a control in the expansion space initially provided on the right and 
bottom of the canvas, a new row or column is added to accommodate the size of 
the control. 

• Stretch a control to span multiple rows or columns. Do this as follows: 

1. Select the control with mouse button 1 

2. Press an Alt key and drag a corner handle of the control to the far side of the 
row or column that the control is to end in. 

• Add or remove rows. Do this as follows: 

1. Press mouse button 2 and select the Rows choice in the contextual menu. 

2. Select the Add row after, the Add row before, or the Delete row choice 
from the submenu. 

• Add or remove columns. Do this as follows: 

1. Select the Columns choice in the contextual menu. 

2. Select the Add column after, the Add column before, or the Delete 
column choice from the submenu. 

• Create expansion space between controls so they remain evenly spaced when the 
user resizes the canvas. Do this by changing the Expand value for rows and 
columns between controls to y (yes). Change these values in the Rows table and 
the Columns table on the IMultiCellCanvas General settings page. 

The initial expansion space on the right or bottom of the canvas is removed when 
you make a column or row expandable. 

You can also add and remove rows and columns in these tables. 
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Attributes 


• Create right and bottom margins for the multicell canvas. Do this by adding a 
row and column at the right and bottom. Do not place any controls in these 
margins. 

• Add a handler for all parts on the canvas. Do this as follows: 

- Add the handler name and parameters in the Handler list field on the 
IMultiCellCanvas Handlers settings page. 

- Type the .hpp file name for the handler in the Class Editor Required 
include files field. 


IMultiCellCanvas 


Figure 91 (Page 1 of 2). Attributes - IMultiCellCanvas. (S is Set, E is Event) 


Attribute 

S E 

Data type 

activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObject 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidiSupported 


Boolean 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

defaultCell 

■ 

ISize 

defaultPushButton 


IWindowHandle 

disabledBackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

dragLines 

■ 

Boolean 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

gridLines 

■ 

Boolean 

group 

■ 

Boolean 

handle 


IWindowHandle 

hiliteBackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 

menu 


IRectangle 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

origDefaultButtonHandle 


IWindowHandle 

owner 

■ 

IWindow* 

parent 

■ 

IWindow* 
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Figure 91 (Page 2 of 2). Attributes - IMultiCellCanvas. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

parents ize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IMultiCellCanvas 

Figure 92 (Page 1 of 2). Actions - IMultiCellCanvas 


Action Parameters 


addToCell 

IWindow* childWindow 

applyBidiSettings 

unsigned long startingColumn 
unsigned long starting Row 
unsigned long numberOfColumns- 
unsigned long numberOfRows=\ 
BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh= true 

Boolean capture=tme 

columnWidth 

unsigned long column 

convertToGUIStyle 

IBitFlag& style 

disable 

disableDragLines 

disableGridLines 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly= false 

IEvent& event 

enable 

Boolean callDefProc= true 
Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tme 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isColumnExpandable 

IEvent& exceptionEvent 

unsigned long column 

isLayoutDistorted 

unsigned long layoutAttribute 

isRowExpandable 

unsigned long row 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 
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Figure 92 (Page 2 of 2). Actions - IMultiCellCanvas 

Action Parameters 


positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

removeF romCell 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

rowHeight 

sendEvent 


setColumnWidth 


setFocus 

setLayoutDistorted 

setRowHeight 


show 

showSourceEmphasis 

windowInCell 


IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameterl& parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
unsigned long column 
unsigned long row 


unsigned long row 
unsigned long eventld 
IEventParameterl& parml=0 
IEventParameter2& parm2= 0 
unsigned long column 
unsigned long widthlnPixels 
Boolean expandable= false 

unsigned long layoutAttributesOn 
unsigned long layoutAttributesOjf 
unsigned long row 
unsigned long heightlnPixels 
Boolean expandable=fa\se 
Boolean visible= true 
Boolean show= true 
unsigned long startingColumn 
unsigned long startingRow 
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Events - IMultiCellCanvas 

Figure 93. Events - IMultiCellCanvas 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIB LETRUEID 


General Settings - IMultiCellCanvas 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Controls 

Defines the name of all rows and columns that appear on the multicell canvas, and 
sets how many rows and columns to display. 

Default value: None 

Rows 

Sets the number and height of rows, and whether or not their height can be 
adjusted. 

Default value: Nil 
Columns 

Sets the number and width of columns, and whether or not they can be widened. 

Default value: Foreground is selected 
Add 

Adds a row or column to the multicell canvas. 

Default value: Selectable 
Add after 

Adds a row or column to the multicell canvas after the the selected row or column. 
Default value: Not selectable 
Add before 

Adds a row or column to the multicell canvas before the the selected row or 
column. 

Default value: Not selectable 
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Delete 

Deletes the selected row or column from the canvas. 

Default value: Not selectable 


Control Settings - IMultiCellCanvas 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IMultiCellCanvas 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
dragLines 

Adds draggable grid lines between the rows and columns of the multicell canvas. 
Default value: The default is off, and the Default radio button is selected. 

gridLines 

Adds grid lines between the rows and columns of the multicell canvas. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 


Chapter 34. IMultiCellCanvas 275 



parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IMultiCellCanvas 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 
Default value: None 
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Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IMultiCellCanvas 

Color area 

Sets the color of the given area. Choices are as follows: 

Background 

Sets the color for background text 

Default value: Background is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the canvas. 

Default value: Red=255, Green=255, Blue=255 


Chapter 34. IMultiCellCanvas 277 



Size/Position Settings - IMultiCellCanvas 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IMultiCellCanvas 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 35. IMultiLineEdit 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM multiple-line edit control 

IMultiLineEdit 

ITextControl 

Visual part 

vbbase.vbb 



An IMultiLineEdit part is a multiple-line entry (MLE) field. 

The user can type or place text into the multiple-line entry field. 

Use an IMultiLineEdit part to let the user define or view multiple-line text data. 
Alternatively, use an IEntryField part for single-line data. 


Building Guidelines - IMultiLineEdit 

When building with an IMultiLineEdit part, you can do the following: 

• Prime the multiple-line entry (MLE) field with variable initial data. Do this by 
connecting your data source to the text attribute. Your application should make 
this connection before it shows the frame window. 

• Allow the user to reach the entry field by using a tab key. Do this by setting the 
tabStop field to On on the IMultiLineEdit Styles settings page. 

• Load the MLE when the user presses the OK push button in a file dialog. Do 
this with an IMultiLineEdit part and an IVBFileDialog as follows: 

1. Connect the IVBFileDialog pressedOK event to the IMultiLineEdit 
importFromFile action. 

2. Connect the IVBFileDialog fileName attribute to the file Name parameter of 
the pressedOK-to-importFromFile connection. 
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• Save the contents of the MLE to a file when the user presses the OK push button 
in a file dialog. Do this with an IMultiLineEdit part and an IVBFileDialog as 
follows: 

1. Connect the IVBFileDialog pressedOK event to the IMultiLineEdit 
exportToFile action. 

2. Connect the IVBFileDialog fileName attribute to the fileName parameter of 
the pressedOK-io-exportToFile connection. 


Attributes - IMultiLineEdit 


Figure 94 (Page 1 of 2). Attributes - IMultiLineEdit. (S is Set, E is Event) 

Attribute S E Data type 


activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

changed 


Boolean 

characterSize 


ISize 

clipboardHasTextFormat 


Boolean 

cursorLinePosition 

■ 

unsigned long 

cursorPosition 

■ 

unsigned long 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

displaySize 


ISize 

editRegionHeight 

■ 

unsigned long 

editRegionWidth 

■ 

unsigned long 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


I Windo wHandle 

hasSelectedText 


Boolean 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

limit 

■ ■ 

unsigned long 

menu 



messageQueue 


IMessageQueueHandle 
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Actions 


Figure 94 (Page 2 of 2). Attributes ■ 

■ IMultiLineEdit. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

numberOfLines 



unsigned long 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

selectedRange 



IRange 

selectedText 



IString 

selectedT extLength 



unsigned long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

top 

■ 


unsigned long 

undoable 



Boolean 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleLines 



unsigned long 

visibleRectangle 



IRectangle 

wordwrap 

■ 


Boolean 

writeable 

■ 

■ 

Boolean 


IMultiLineEdit 

Figure 95 (Page 1 of 3). Actions ■ 

■ IMultiLineEdit 

Action 

Parameters 

add 

char* text 

unsigned long textSize= 0 

EOLFormat ty/?e=IMultiLineEdit::cfText 

addAsLast 

char* text 

unsigned long textSize= 0 

EOLFormat ty/?e=IMultiLineEdit::cfText 

addAtOffset 

char* text 

unsigned long charnumber 
unsigned long textSize= 0 

EOLFormat ty/?£=IMultiLineEdit::cfText 

addLine 

char* text 

unsigned long lineNumber 

EOLFormat ty/?e=IMultiLineEdit::cfText 

addLineAsLast 

char* text 
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Figure 95 (Page 2 of 3). Actions - IMultiLineEdit 

Action Parameters 


applyBidiSettings 


capturePointer 

clear 

convertToGUIStyle 

copy 

cut 

disable 

disableDataUpdate 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

disableWordWrap 

discard 

dispatchRemainingHandlers 

enable 

enableUpdate 

exportSelectedTextToFile 

exportToFile 

handleException 

hide 

hideSourceEmphasis 

importFromFile 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

paste 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

removeAll 

removeLine 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetChangedFlag 


EOLFormat Zy/?e=IMultiLineEdit: xfText 

BidiSettings& settings 

Boolean childlnherit= true 

Boolean refresh=\me 

Boolean capture= true 

unsigned long timestamp=0 

IBitFlag& style 

Boolean extendedOnly= false 

unsigned long timestamp=0 

unsigned long timestamp- 0 


IEvent& event 
Boolean callDefProc=tr\iQ 
Boolean enabled= true 
Boolean enableWindow= true 
char* fdeName 

EOLFormat Zy/?e=IMultiLineEdit: xfText 
char* fdeName 

EOLFormat Zy/?e=IMultiLineEdit: xfText 
IException& dispatcherException 
IEvent& exceptionEvent 


char* fileName 

EOLFormat Jy/?e=IMultiLineEdit: xfText 
unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 

IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 

unsigned long lineNumber 
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Figure 95 (Page 3 of 3). Actions ■ 

■ IMultiLineEdit 

Action 

Parameters 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

selectRange 

constIRange&range =IRange(0,end) 

sendEvent 

unsigned long timestamp=0 
unsigned long eventld 

setChangedFlag 

IEventParameterl& parml=0 

IEventParameter2& parm2= 0 

Boolean changed= true 

setEditRegion 

setFocus 

setLayoutDistorted 

unsigned long layoutAttributesOn 

setTab 

unsigned long layoutAttributesOff 
unsigned long tabPixellnterval 

show 

Boolean visible=tme 

showSourceEmphasis 

Boolean show=tme 

undo 



Events - IMultiLineEdit 


Figure 96. Events - IMultiLineEdit 


Event 

Notification ID 

commandEvent 

commandld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCU SFALSEID 

systemCommandEvent 

sy stemC ommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 

General Settings - IMultiLineEdit 


Subpart name 


Sets the name of the subpart (a part placed on a composite part). 


Default value: The name of the part 


Text 

Sets the text for the part. 

Default value: The name of the part 
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Limit 

Sets the length (in bytes) of the longest text the part can hold. 
Default value: 4 294 967 295 


Control Settings - IMultiLineEdit 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IMultiLineEdit 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
border 

Draws a border around the frame window, or sets the color of the border that 
surrounds the button window. 

Default value: The Default radio button is selected. 

readonly 

Prevents entering input into the field. 

Default value: The default is off, and the Default radio button is selected. 
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horizontals cr oil 

Provides a horizontal scroll bar for the part. 

Default value: The default is on, and the Default radio button is selected. 

verticalScroll 

Provides a vertical scroll bar for the part. 

Default value: The Default radio button is selected. 

ignoreTab 

Sets the MLE so it ignore tab key strokes. The function sends a keyboard event to 
the owner of the MLE. 

Default value: The Default radio button is selected, 
wordwrap 

Sets the word-wrap style for the part. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 
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clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IMultiLineEdit 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 
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Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IMultiLineEdit 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Size/Position Settings - IMultiLineEdit 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IMultiLineEdit 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 36. INotebook 

IBM notebook control 
INotebook 
IControl 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 



An INotebook part is a software representation of a physical notebook. It presents 
information on pages and marks the first page of each section with a tab. 

The user can do the following with a notebook: 

• Turn the pages by clicking on page buttons 

• Move directly to a section by selecting a tab 

• View or change information by using other controls 

Use an INotebook part for settings choices or for information that can be organized 
into sections. 


Building Guidelines - INotebook 

When building with an INotebook part, you can do the following: 

• Place a notebook in a frame window. Do this by selecting an INotebook part 
from the parts palette and dropping it on the client area of a frame window. 

• Define the orientation of a notebook. Do this by selecting the back page and 
major tab orientation you want in the Layout field on the INotebook General 
settings page. 

• Define the binding for a notebook. Do this by selecting the Solid or Spiral 
choice in the Binding field on the INotebook General settings page. 
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• Define tab appearance for a notebook. Do this by selecting the shape you want 
in the tabShape field and the tab text alignment you want in the Tab 
Justification field on the INotebook General settings page. 

By default, the tab size is determined by the underlying class. If you want to set 
a tab size, set the majorTab and minorTab fields on the INotebook General 
settings page. 

• Define the alignment of status text at the bottom of each notebook page. Do this 
by selecting the alignment you want in the Status area Justification field on the 
INotebook General settings page. 

• Add a page to a notebook. Do this by clicking mouse button 2 on the notebook 
and selecting an add page choice. When there are no pages in the notebook, 
your only page choice is Add Initial Page. When the notebook has one or more 
pages, select Add Page After or Add Page Before. An IVBNotebookPage part 
is placed in the notebook. 


Attributes - INotebook 

Figure 97 (Page 1 of 2). Attributes - INotebook. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

binding 

■ 

Binding 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

empty 


Boolean 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

firstPage 


IPageHandle 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


I Windo wHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

itemProvider 

■ 

IDMItemProvider* 
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Figure 97 (Page 2 of 2). Attributes ■ 

■ INotebook. 

(S is Set, E is Event) 

Attribute 

S 

E 

Data type 

lastPage 



IPageHandle 

lay out Adjustment 



IRectangle 

majorTabBackgroundColor 

■ 

■ 

IColor 

maj or T abF or eground Color 

■ 

■ 

IColor 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

minor TabBackground Color 

■ 

■ 

IColor 

minorT abF oregroundColor 

■ 

■ 

IColor 

nativeRect 



IRectangle 

orientation 

■ 

■ 

Orientation 

owner 

■ 


IWindow* 

pageBackgroundColor 

■ 

■ 

IColor 

pageSize 



ISize 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

statusT ext Alignment 

■ 


TextAlignment 

tabShape 

■ 


TabShape 

tabStop 

■ 


Boolean 

tabT ext Alignment 

■ 


TextAlignment 

topPage 



IPageHandle 

totalPages 



unsigned long 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 
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Figure 98 (Page 1 of 3). Actions - INotebook 


Action 

Parameters 

addFirstPage 

PageSettings& pagelnfo 


IWindow* pageWindow=0 

addLastPage 

PageSettings& pagelnfo 


IWindow* pageWindow=0 

addPageAfter 

PageSettings& pagelnfo 


Cursor& cursor 


IWindow* pageWindow=0 

addPageBefore 

PageSettings& pagelnfo 


Cursor& cursor 


IWindow* pageWindow=0 

applyBidiSettings 

BidiSettings& settings 


Boolean childlnherit= true 
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Figure 98 (Page 2 of 3). Actions - INotebook 

Action 


capturePointer 

convertToGUIStyle 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

nextPage 

notebookSize 

notifyObservers 

pageSettings 

pagesToEnd 

pagesToMajorTab 

pagesT oMinor T ab 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

previousPage 

refresh 

refreshTabs 

releasePointer 

releasePresSpace 

removeAllPages 

removePage 

remo veT abSection 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 

resetMajorTabBackgroundColor 


Parameters 

Boolean refresh^ true 
Boolean capture= true 
IBitFlag& style 
Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow= true 
IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long layoutAttribute 
unsigned short character 
IPageHandle& referencePage 
IPageHandle& page 
INotificationEvent& event 
Cursor& cursor 
Cursor& cursor 
Cursor& cursor 
Cursor& cursor 

IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IPageHandle& referencePage 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 

IPageHandle& page 
IPageHandle& page 
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Figure 98 (Page 3 of 3). Actions - INotebook 

Action Parameters 


resetMajorT abF oreground Color 
resetMinimumSize 
resetMinorTabBackgroundColor 
resetMinorT abF oreground Color 
resetPageBackgroundColor 
resetShadowColor 
sendEvent 


setFocus 

setLayoutDistorted 

setMajorTabSize 
setMinorT abSize 
setPageButtonSize 
setStatusText 

setTabBitmap 

setTabText 

setUserData 

setWindow 

show 

showSourceEmphasis 

turnToPage 

window 


unsigned long eventld 
IEventParameter 1 & parml =0 
IEventParameter2& parm2=0 

unsigned long layoutAttributesOn 
unsigned long layoutAttributesOff 
ISize& sizeMajorTab 
ISize& sizeMinorTab 
ISize& sizePageButton 
IPageHandle& referencePage 
IResourceId& resourceld 
IPageHandle& referencePage 
IResourceId& resourceld 
IPageHandle& referencePage 
char* tabText 

IPageHandle& referencePage 
unsigned long userData 
IPageHandle& referencePage 
I Window* pageWindow=0 
Boolean visible^ true 
Boolean show= true 
Cursor& cursor 
IPageHandle& page 


Events - INotebook 

Figure 99. Events - INotebook 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 
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General Settings - INotebook 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Layout 

Defines the placement and layout of the part. 

Default value: First orientation (to the left of those shown) selected 

Binding 

Sets the type of binding used for the notebook. 

Default value: Solid 
tabShape 

Sets the shape of the notebook tabs. 

Default value: Square 
Preview 

Lets you preview the text, which displays in the current font. 

Default value: Tab tab on the right appears as Page 1 

Justification 

Defines the alignment for the text in the status line for the notebook. 

Default value: Left 
Tab 

Defines the alignment for the text in the tabs for the notebook. 

Default value: Left 
Width 

Sets the width of the arrow push button on the notebook page. 

Default value: None 
Height 

Sets the height of the arrow push button on the notebook page. 

Default value: None 
Width 

Sets the size (width) of the major tabs in the notebook, in pixels. 

Default value: None 
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Height 

Sets the size (height) of the major tabs in the notebook, in pixels. 

Default value: None 
Width 

Sets the size (width) of the minor tabs in the notebook, in pixels. 

Default value: None 
Height 

Sets the size (height) of the minor tabs in the notebook, in pixels. 

Default value: None 


Control Settings - INotebook 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - INotebook 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
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following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 
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Handlers Settings - INotebook 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - INotebook 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Page background 

Sets the color of the page background 

Major tab background 

Sets the color of the background for the major tab 
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Major tab foreground 

Sets the color of the foreground for the major tab 

Minor tab background 

Sets the color of the background for the minor tab 

Minor tab foreground 

Sets the color of the foreground for the minor tab 

Default value: Background is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the notebook. 

Default value: Red=204, Green=204, Blue=204 


Size/Position Settings - INotebook 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
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Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - INotebook 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 37. INumericSpinButton 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM spin-button control with numeric contents 

INumericSpinButton 

IBaseSpinButton 

Visual part 

vbbase.vbb 



An INumericSpinButton part is a ring of numeric choices. One choice is visible at a 
time. 

The user can spin the ring upward or downward to select another choice. 

Use an INumericSpinButton part to provide, in sequence, a ring of related but 
mutually exclusive numeric choices. For example, use a spin button for a numeric 
selection list of the months of the year. 

Alternatively, use an ITextSpinButton for a ring of text choices. 


Building Guidelines - INumericSpinButton 

When building with an INumericSpinButton part, you can do the following: 

• Define the range of numbers for the spin button. Do this by setting the Numeric 
range field on the INumericSpinButton General settings page. 

• Define a default selection for the spin button. Do this by setting the Value field 
on the INumericSpinButton General settings page. 

• Align numeric values to the right in the spin button entry field. Do this by 
selecting the Right setting in the Alignment field on the INumericSpinButton 
General settings page. 

• Prevent the user from typing a choice. Do this by setting the Read only field on 
the INumericSpinButton Styles settings page. 

• Make the spin button skip values to cycle faster when the user continues to spin 
the button. Do this by setting the Fast spin field on the INumericSpinButton 
Styles settings page. 
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• Copy the selection from the spin button to a numeric connection parameter or 
attribute. Do this by connecting the INumericSpinButton value attribute to the 
numeric target. 


Attributes - INumericSpinButton 


Figure 100 (Page 1 of 2). Attributes - INumericSpinButton. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

alignment 

■ 


Alignment 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

border 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

defaultPushButton 



I Windo wHandle 

di sabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

fastSpinEnabled 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



I Windo wHandle 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

limit 

■ 


unsigned long 

master 



Boolean 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parents ize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

range 

■ 


IRange 

rect 

■ 


IRectangle 

servant 



Boolean 
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Actions 


Figure 100 (Page 2 of 2). Attributes - INumericSpinButton. (S is Set, E is Event) 


Attribute 

S E 

Data type 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

spinFieldValid 


Boolean 

tabStop 

■ 

Boolean 

valid 


Boolean 

value 

■ ■ 

long 

visible 

■ ■ 

Boolean 

visibleRectangle 


IRectangle 

writeable 

■ 

Boolean 

umericSpinButton 

Figure 101 (Page 1 of 2). Actions ■ 

■ INumericSpinButton 


Action 

Parameters 


addB order 

Boolean add- 

=true 

applyBidiSettings 

BidiSettings& settings 


capturePointer 
con vertT oGUIS ty le 


Boolean childlnherit= true 
Boolean refresh=\me 
Boolean capture=ime 
IBitFlag& style 
Boolean extendedOnly=fa\se 


disable 

disableDataUpdate 

disableFastSpin 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 


IEvent& event 
Boolean callDefProc= true 
Boolean enable d= true 
Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 


hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 


unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameterl& parm 1=0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
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Figure 101 (Page 2 of 2). Actions - INumericSpinButton 

Action Parameters 


removeB order 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledB ackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 
resetMinimumSize 
resetShadowColor 
sendEvent 


setFocus 

setLayoutDistorted 

setMaster 

show 

showSourceEmphasis 

spinDown 

spinTo 

spinUp 


unsigned long eventld 
IEventParameter 1 & parml—0 
IEventParameter2& parm2— 0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
IBaseSpinButton& master 
Boolean visible=tme 
Boolean show= true 
unsigned long spinBy= 1 
long aValue 

Boolean spinToClosest=f&\se 
unsigned long spinBy- 1 


Events - INumericSpinButton 

Figure 102. Events - INumericSpinButton 

Event Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

textEvent 

valueEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

EN AB LETRUEID 

FOCUSFALSEID 

systemCommandld 

textld 

valueld 

VISIBLEFALSEID 
VISIB LETRUEID 
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General Settings - INumericSpinButton 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Alignment 

Changes the text alignment of the part. Left aligns the text to the left. Center 
centers the text, and Right aligns the text at the right. 

Default value: Left 

Numeric range 

Sets a range of values for an attribute of the part. The Lower field sets the lower 
limit of the range for a spin button part, while the Upper field sets the upper limit. 

Default value: 0 

Value 

Sets the current value for the spin button. 

Default value: 0 
Limit 

Sets the length (in bytes) of the longest text the part can hold. 

Default value: 32 


Control Settings - INumericSpinButton 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 

Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
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Enabled 

Enables the handler by default. 
Default value: Selected 


Styles Settings - INumericSpinButton 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
padWithZeros 

Pads the displayed number with zeros at the front. 

Default value: The Default radio button is selected. 

readonly 

Prevents entering input into the field. 

Default value: The default is off, and the Default radio button is selected. 

noBorder 

Suppresses the drawing of a border. 

Default value: The Default radio button is selected. 

fastSpin 

Enables the spin button to increase the spin speed with time. The speed doubles 
every two seconds. 

Default value: The Default radio button is selected, 
master 

Specifies that the spin button component consists of: 

• One or more single-line entry fields (SLE) or spin fields 

• Two arrows—the Up arrow and the Down arrow 

When a spin button contains more than one spin field, the master component 
contains the spin arrows. If the component contains only one spin field, it must be 
the master. 

Default value: The default is on, and the Default radio button is selected, 
servant 

Allows the user to create a multiple-field spin button by spinning servants from the 
master. 

Default value: The default is off, and the Default radio button is selected. 
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group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 
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visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - INumericSpinButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - INumericSpinButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 
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Disabled foreground 

Sets the foreground color for disabled text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - INumericSpinButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
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Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - INumericSpinButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 38. lOutlineBox 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM outline control without text label 

lOutlineBox 

IControl 

Visual part 

vbbase.vbb 


RadioButtonl 

RadioButton2 


An lOutlineBox part is an unlabeled rectangular box that can contain a group of 
related user-interface controls. 

The user can move through the controls in a group using the keyboard cursor keys. 
When the user moves the cursor forward from the last control in the group, the cursor 
returns to the first control in the group. 

Use an lOutlineBox part to visually group a set of controls without labeling the 
group. Alternatively, use an IGroupBox part if you want to label the group. 


Building Guidelines - lOutlineBox 

When building with an lOutlineBox part, you can do the following: 

• Define a set of related controls in a group box. Do this as follows: 

1. Select an lOutlineBox part from the parts palette and drop it on a canvas. 

2. Resize the outline box to the size you think you need by selecting it on the 
canvas and dragging a corner handle. 

3. Add the controls you want in the outline box. 

If you add the outline box after adding the controls you are enclosing, you must 
change the tabbing and depth order of controls on the canvas to position the 
outline box ahead of the controls within it. Do this by clicking mouse button 2 
on the canvas and selecting the Tabbing And Depth Order choice. Then, press 
mouse button 2 on the outline box in the Tabbing And Depth Order panel and 
drag it to a new position just before the first control it contains. 
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• Make the controls in the outline box a cursoring group that the user can reach 
with a tab key. The user can cycle through controls in a cursoring group using 
the keyboard cursor keys. 

Do this by setting the group and tabStop fields to On on the Styles settings 
page of the first control in the outline box. Leave these fields set to Off for the 
rest of the controls in the outline box. 

Also make sure that the first control following the outline box on your canvas 
has the group field set to On. This makes the last control in the outline box the 
end of the cursoring group. You can view and modify the group and tabStop 
settings of controls in the Tabbing And Depth Order panel. 


Attributes - lOutlineBox 


Figure 103 (Page 1 of 2). Attributes ■ 

■ lOutlineBox. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

defaultPushButton 



I Windo wHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



I Windo wHandle 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

outlineType 

■ 


OutlineType 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 
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Figure 103 (Page 2 of 2). Attributes ■ 

■ lOutlineBox. (S is Set, E is Event) 

Attribute 

S E 

Data type 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

tabStop 

■ 

Boolean 

valid 


Boolean 

visible 

■ ■ 

Boolean 

visibleRectangle 


IRectangle 


Actions - lOutlineBox 

Figure 104 (Page 1 of 2). Actions - lOutlineBox 

Action Parameters 


applyBidiSettings 


capturePointer 
con vertT oGUIS ty le 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 


BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh=\me 
Boolean capture=true 
IBitFlag& style 
Boolean extendedOnly =false 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 


unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& sibling Window 


unsigned long eventld 
IEventParameterl& parml= 0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
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Figure 104 (Page 2 of 2). Actions - 

■ IOutlineBox 

Action 

Parameters 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 

unsigned long eventld 

setFocus 

setLayoutDistorted 

IEventParameter 1 & parml=0 

IEventParameter2& parm2= 0 

unsigned long lay outAttribute sOn 

show 

unsigned long lay outAttribute sOff 

Boolean visible=tme 

showSourceEmphasis 

Boolean show= true 


Events - IOutlineBox 

Figure 105. Events - IOutlineBox 

Event 

Notification ID 

commandEvent 

commandld 

gotFocusEvent 

FOCUSTRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 

General Settings - IOutlineBox 


Subpart name 


Sets the name of the subpart (a part placed on a composite part). 

Default value: The name 

of the part 
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Control Settings - lOutlineBox 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - lOutlineBox 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 
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clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - lOutlineBox 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 
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Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - lOutlineBox 

Outline type 

Sets the type of outline. 

Default value: Foreground color 
Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the canvas. 

Default value: Red=255, Green=255, Blue=255 
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Size/Position Settings - lOutlineBox 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - lOutlineBox 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 39. IProgressIndicator 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM read-only slider control 

IProgressIndicator 

IControl 

Visual part 

vbbase.vbb 


I 


An IProgressIndicator part shows the progress of a task. A horizontal or vertical 
shaft represents the task. 

An arm moves along the shaft to show the progress of the task. The arm starts at 
one end of the shaft, called the home position, and reaches the other end when the 
task finishes. The shaft can be colored between the home position and the arm to 
emphasize the progress of the task. This colored portion of the shaft is called a 
ribbon strip. 

The user can note the progress of a task by observing the progress indicator. If your 
application provides a push button with cancel support, the user can end the task. 

Use an IProgressIndicator part to provide a visual measure of the progress of a task. 
Use a progress indicator for tasks of significant duration. 


Building Guidelines - IProgressIndicator 

When building with an IProgressIndicator part, you can do the following: 

• Define the value scale for the progress indicator. Do this as follows: 

- Enter the number of ticks in the Number of ticks field on the 
IProgressIndicator General settings page. 

- Select the location of the scale of tick marks and text relative to the progress 
indicator. Do this by selecting a choice in the Primary scale field on the 
IProgressIndicator General settings page. If you want the scale above a 
horizontal progress indicator or to the right of a vertical indicator, select the 
Scale 1 choice. If you want the scale below a horizontal progress indicator 
or to the left of a vertical indicator, select the Scale 2 choice. 
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- Add scale tick marks and text to the progress indicator. Do this using 
custom logic. Click mouse button 2 on the free-form surface and connect 
the composite part ready event to IProgressIndicator Custom logic. Enter 
C++ code to set the size and text for each tick mark. 

For example, if you want to show percentage of completion with marks at 
ten-percent intervals, you could enter the following code: 

for (int i = 0; i < 101; i += 10) 


target->setTickLength(i, 10); 
target->setTickText(i, IString(i)); 

} 

• Add a ribbon strip to the progress indicator. Do this by setting the Ribbon strip 
field to On on the IProgressIndicator Styles settings page. 

• Determine the orientation of the progress indicator. By default, the orientation is 
horizontal. To orient the progress indicator vertically, set the vertical field to On 
and the set the horizontal field to Off on the IProgressIndicator Styles settings 
page. 

• Define the home position for the progress indicator. Do this by selecting a 
choice in the Home position field on the IProgressIndicator General settings 
page. If you want the home position at the left of a horizontal progress indicator 
or at the bottom of a vertical indicator, select the Left or bottom choice. If you 
want the home position at the right of a horizontal progress indicator or at the top 
of a vertical indicator, select the Top or right choice. 

• If you want the initial arm offset somewhere other than at the home position, set 
the Arm offset field on the IProgressIndicator General settings page. Specify 
either a tick offset for Ticks or a pixel offset for Pixels. 

• Force the arm to the nearest tick if you use a pixel offset. Do this by setting the 
snapToTickMark field to On on the IProgressIndicator Styles settings page. 

• Advance the arm to indicate progress. Do this by connecting the source of your 
progress information to the IProgressIndicator armTickOffset attribute, providing 
the new tick location of the arm. 
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Attributes - IProgressIndicator 


Figure 106 (Page 1 of 2). Attributes - IProgressIndicator. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

alignment 



Alignment 

armPixelOffset 

■ 

■ 

unsigned long 

armRange 



unsigned long 

armTickOffset 

■ 

■ 

unsigned long 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObject 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

defaultPushButton 



IWindowHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

drawItemEnabled 

■ 


Boolean 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

homePosition 

■ 


HomePosition 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

primaryScale 

■ 

■ 

Scale 

rect 

■ 


IRectangle 

ribbonStripEnabled 

■ 


Boolean 

shadowColor 

■ 

■ 

IColor 

shaftPosition 

■ 


IPoint 

shaftSize 



ISize 

showing 



Boolean 


Chapter 39. IProgressIndicator 


327 




Figure 106 (Page 2 of 2). Attributes - IProgressIndicator. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

size 

■ 

■ 

ISize 

snapToTickEnabled 

■ 


Boolean 

tabStop 

■ 


Boolean 

valid 



Boolean 

vertical 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IProgressIndicator 

Figure 107 (Page 1 of 2). Actions - IProgressIndicator 

Action Parameters 


applyBidiSettings 


capturePointer 

convertToGUIStyle 

disable 

disableDrawItem 

disableGroup 

disableNotification 

disableRibbonStrip 

disableSnapToTick 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

numberOfTicks 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 
releasePresSpace 
resetActiveColor 
resetB ackgroundColor 


BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh^ true 
Boolean capture=tm& 
IBitFlag& style 
Boolean extendedOnly=fdlse 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 


unsigned long layoutAttribute 
unsigned short character 
INotificationEvent& event 
Scale scale 

IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
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Figure 107 (Page 2 of 2). Actions ■ 

■ IProgressIndicator 

Action 

Parameters 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 

unsigned long eventld 

setFocus 

setLayoutDistorted 

IEventParameter 1 & parml=0 

IEventParameter2& parm2= 0 

unsigned long layoutAttributesOn 

setShaftBreadth 

unsigned long lay outAttribute sOjf 
unsigned long breadth 

setTickLength 

unsigned long tickNumber 

setTicks 

unsigned long length 

unsigned long scaleINumberOfTicks 

setTickText 

unsigned long scale2NumberOfTicks 
unsigned long scalelTickSpacing=0 
unsigned long scale2TickSpacing= 0 
unsigned long tickNumber 

show 

char* text 

Boolean visible= true 

showSourceEmphasis 

Boolean show= true 

tickLength 

unsigned long tickNumber 

tickPosition 

unsigned long tickNumber 

tickSpacing 

Scale scale 

tickText 

unsigned long tickNumber 


Events - IProgressIndicator 

Figure 108. Events - IProgressIndicator 

Event 

Notification ID 

commandEvent 

commandld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCU SFALSEID 

scaleEvent 

scaleld 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 
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General Settings - IProgressIndicator 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Number of ticks 

Sets the number of ticks. 

Default value: 2 
Tick spacing 

Sets the number of pixels between ticks for the specified scale. 

Default value: None 
Ticks 

Sets the position of the arm as a tick number. Ticks are numbered starting at zero. 

Default value: 0 
Pixels 

Sets the offset of the arm from the home position. 

Default value: 0 
Home position 

Sets the home position of the progress indicator. 

Default value: Left or bottom 
Primary scale 

Sets the primary scale of the progress indicator. 

Default value: Scale 1 


Control Settings - IProgressIndicator 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
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Help panel id 

Sets the help panel identifier for the part. 
Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IProgressIndicator 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
horizontal 

Creates a horizontal scroll bar. This style is ignored if it is used with vertical. 

A deck of child windows is arranged in the canvas horizontally in rows from left to 
right. Decks of rows are arranged from top to bottom. 

Default value: The default is off, and the Default radio button is selected. 

snapToTickMark 

Specifies that the progress indicator arm snap to the nearest tick when moved 
between two ticks. 

Default value: The Default radio button is selected. 

ribbonStrip 

Sets the default ribbonStrip style. 

Default value: The Default radio button is selected. 

handleDrawItem 

Generates a draw item event to allow the application to draw the part. 

Default value: The Default radio button is selected, 
vertical 

Creates a vertical scroll bar. This style is used if both it and horizontal are 
specified. 

A deck of child windows is arranged in the canvas vertically in columns from top 
to bottom. Decks of columns are arranged from left to right. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
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following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 
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Handlers Settings - IProgressIndicator 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IProgressIndicator 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Border 

Sets the color of the border drawn around the children of the frame window. 

Default value: Foreground is selected 
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Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - IProgressIndicator 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
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Width 

Sets the minimum-allowable width, which is set by the user’s class. 
Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 
Default value: None (calculated at execution time) 


Font Settings - IProgressIndicator 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 40. IPushButton 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM push-button control 

IPushButton 

IButton 

Visual part 

vbbase.vbb 


Add 


An IPushButton part is a selection button for an action or routing choice. The choice 
is identified by text on the push button. 

The user can click the push button to perform the indicated function. 

Use an IPushButton part to let the user confirm changes or request a function. OK 
and Help push buttons are commonly used examples. 

Alternatively, to identify the choice with a graphic image, use an IGraphicPushButton 
part. 


Building Guidelines - IPushButton 

When building with an IPushButton part, you can do the following: 

• Assign text to the push button. Do this by setting the Text field on the 
IPushButton General settings page. 

• Make the push button be the initial default button. Do this by setting the 
defaultButton field on the IPushButton Styles settings page. 

• Allow the user to reach the button by using a tab key. Do this by setting the 
tabStop field to On on the IPushButton Styles settings page. 

• If the button is the first control in a group, allow the user to use cursor keys to 
move between the button and follow controls in the group. Do this by setting the 
group field to On on the IPushButton Styles settings page. 

• Start the action represented by the button. Do this by connecting the 
IPushButton buttonClickEvent feature to the action on the target part. 

• Open your application help with the push button. Do this by selecting the Help 
and noPointerFocus fields on the IPushButton Styles settings page. 
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• Enable or disable the push button when an event occurs. 

Enable the button as follows: 

1. Connect the event to the IPushButton enable action. 

2. Open settings for the connection, press the Set parameters push button, and 
check the enabled setting. 

Disable the button by connecting the event to the IPushButton disable action. 


Attributes - IPushButton 


Figure 109 (Page 1 of 2). Attributes - IPushButton. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

allowsMouseClickFocus 

■ 


Boolean 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

border 

■ 


Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

default 

■ 


Boolean 

defaultPushButton 



IWindowHandle 

di sabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

help 

■ 


Boolean 

highlighted 



Boolean 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 
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Figure 109 (Page 2 of 2). Attributes ■ 

■ IPushButton. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

systemCommand 

■ 

■ 

Boolean 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IPushButton 

Figure 110 (Page 1 of 2). Actions - IPushButton 

Action Parameters 


applyBidi Settings 

capturePointer 

click 

con vertT oGUIS ty le 
disable 

disableDefault 

disableGroup 

disableHelp 

disableMouseClickFocus 

disableNotification 

disableSystemCommand 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 


BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh^ true 
Boolean capture=tme 

IBitFlag& style 

Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 
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Figure 110 (Page 2 of 2). Actions - IPushButton 

Action Parameters 


highlight 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

removeBorder 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledB ackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 

unhighlight 


Boolean highlight= true 
unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 

unsigned long lay outAttribute sOn 
unsigned long lay out Attribute sOjf 
Boolean visible=true, 

Boolean show=t rue 


Events - IPushButton 

Figure 111. Events - IPushButton 

Event Notification ID 


buttonClickEvent 

commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


buttonClickld 

commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIB LETRUEID 
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General Settings - IPushButton 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 


Control Settings - IPushButton 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IPushButton 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
noBorder 

Suppresses the drawing of a border. 

Default value: The Default radio button is selected. 
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defaultButton 

Specifies this push button as the default push button. 

Default value: The default is on, and the Default radio button is selected. 

Help 

Enables help for the part. 

Default value: Not selected 
systemCommand 

Generates a system command event when the user selects the part. 

Default value: The default is off, and the Default radio button is selected. 

noPointerFocus 

Allows the cursor stay on a control for which information is required, rather than 
moving to the button. Buttons with this style do not set the focus to themselves 
when the user clicks on them using the mouse. This has no effect on keyboard 
interaction. 

Default value: The Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 
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clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IPushButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 
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Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IPushButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Size/Position Settings - IPushButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IPushButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 41. IRadioButton 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM radio-button control 

IRadioButton 

ISettingButton 

Visual part 

vbbase.vbb 


RadioButtonl 
* RadioButtonl 
RadioButton3 


An IRadioButton part is a circle with text that represents a settings choice. Selection 
of the choice is indicated by a mark in the radio button. 

The user can select a single choice from a set of radio buttons. When the user selects 
a choice, the previously selected choice is no longer selected. 

Use an IRadioButton part to provide a choice for a set of mutually exclusive choices, 
where one choice is always selected. 

Use radio buttons in a group for a small, fixed set of choices. For example, use a set 
of radio buttons for a choice of sizes, such as small, medium, and large. You can 
also use a set of radio buttons for a set of answers to a multiple-choice question. 

Alternatively, use a group of ICheckBox parts for a set of choices that are not 
mutually exclusive. 


Building Guidelines - IRadioButton 

When building with an IRadioButton part, you can do the following: 

• Set the text for the radio button. Do this by entering the text you want in the 
Text field on the IRadioButton General settings page. 

• Set the initial state of the radio button. Do this by selecting or deselecting the 
Selected field on the IRadioButton General settings page. 

To initially select your radio button, make sure the Selected field check box is 
checked. If it is not checked, click on it with mouse button 1 to select it. 
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To initially not select your check box, make sure the Selected field check box is 
not checked. If it is checked, click on it with mouse button 1 to deselect it. 

• Allow the user to reach the radio button by using a tab key. Do this by setting 
the tabStop field to On on the IRadioButton Styles settings page. 

• If the button is the first control in a group, allow the user to use cursor keys to 
move between the button and follow controls in the group. Do this by setting the 
group field to On on the IRadioButton Styles settings page. 

Placing radio buttons in a group also ensures that when the user selects one radio 
button, the other buttons are deselected. 

• Enable or disable another control when the user selects the radio button. 

Enable the other control by connecting the IRadioButton selected attribute to the 
enabled attribute of the other control. When the user deselects the radio button, 
the other control is disabled. 

Disable the other control by connecting the IRadioButton selected attribute to the 
value attribute of an IVBBooleanPart and then connecting the IVBBooleanPart 
notValue attribute to the enabled attribute of the other control. When the user 
deselects the radio button, the other control is enabled. 

IVBBooleanPart is available in the vbsample.vbb file. 

• Enable or disable the radio button when an event occurs. 

Enable the radio button as follows: 

1. Connect the event to the IRadioButton enable action. 

2. The button is enabled by default. If you have changed this default, open 
settings for the connection, press the Set parameters push button, and check 
the Enabled setting. 

Disable the radio button by connecting the event to the IRadioButton disable 
action. 


Attributes - IRadioButton 


Figure 112 (Page 1 of 2). Attributes ■ 

■ IRadioButton. (S is Set, E is Event) 

Attribute 

S E 

Data type 

activeColor 

■ ■ 

IColor 

allowsMouseClickFocus 

■ 

Boolean 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

autoSelect 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 
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Figure 112 (Page 2 of 2). Attributes ■ 

■ IRadioButton. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasT extFormat 



Boolean 

cursorSelect 

■ 


Boolean 

defaultPushButton 



IWindowHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

highlighted 



Boolean 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

selected 

■ 


Boolean 

selectedlndex 



unsigned long 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabS top 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 
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Actions - IRadioButton 

Figure 113 (Page 1 of 2). Actions - IRadioButton 

Action Parameters 

applyBidiSettings BidiSettings& settings 

Boolean childlnherit= true 
Boolean refresh-\x\XQ 

capturePointer Boolean capture=true 

click 

convertToGUIStyle IBitFlag& style 

Boolean extendedOnly= false 

deselect 

disable 

disableAutoSelect 

disableCursorSelect 

disableGroup 

disableMouseClickFocus 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers IEvent& event 

Boolean callDefProc= true 
Boolean enabled=tme 
Boolean enableWindow=ime 
IException& dispatcherException 
IEvent& exceptionEvent 

Boolean highlight= true 
unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 

resetBorderColor 
resetDisabledBackgroundColor 
resetDisabledForegroundColor 
resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 
resetMinimumSize 
resetShadowColor 


enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

highlight 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 
releasePresSpace 
resetActiveColor 
resetB ackgroundColor 
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Figure 113 (Page 2 of 2). Actions - IRadioButton 

Action Parameters 

sendEvent unsigned long eventld 

IEventParameter 1 & parml =0 
IEventParameter2& parm2= 0 

setFocus 

setLayoutDistorted unsigned long layoutAttributesOn 

unsigned long lay outAttribute sOff 

show Boolean visible= true 

showSourceEmphasis Boolean show= true 

unhighlight 

Events - IRadioButton 

Figure 114. Events - IRadioButton 

Event Notification ID 

buttonClickEvent 
commandEvent 
gotFocusEvent 
inputDisabledEvent 
inputEnabledEvent 
lostFocusEvent 
systemCommandEvent 
visibilityDisabledEvent 
visibilityEnabledEvent 

General Settings - IRadioButton 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 
Selected 

Sets the selection state of the item to selected. 

Default value: Not selected 


buttonClickld 

commandld 

FOCU STRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCU SFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 
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Control Settings - IRadioButton 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IRadioButton 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
noCursorSelect 

Enables selection of the part when the user uses the cursor. 

Default value: The Default radio button is selected. 

autoSelect 

Lets the user change the current selection by moving the cursor. 

Default value: The default is on, and the Default radio button is selected. 

noPointerFocus 

Allows the cursor stay on a control for which information is required, rather than 
moving to the button. Buttons with this style do not set the focus to themselves 
when the user clicks on them using the mouse. This has no effect on keyboard 
interaction. 

Default value: The Default radio button is selected. 
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group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 
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visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IRadioButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IRadioButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 


354 Visual Builder Parts Reference 




Disabled foreground 

Sets the foreground color for disabled text 

Highlighted foreground 

Sets the foreground color for selected text 

Border 

Sets the color of the border that surrounds the part. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - IRadioButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
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Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - IRadioButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 


356 Visual Builder Parts Reference 



Chapter 42. IScrollBar 

IBM scroll-bar control 
IScrollBar 
IControl 
Visual part 
vbbase.vbb 



M 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


An IScrollBar part is a window component consisting of a shaft, a scroll box in the 
shaft, and scroll buttons at the ends of the shaft. A scroll bar is either horizontal or 
vertical, indicating the availability of more information in the same dimension. 

The user can bring information into view using a scroll bar. This is done by moving 
the scroll box along the shaft in the direction of the additional information. The user 
can move the scroll box in any of the following ways: 

• Drag it with the mouse. 

• Click or hold down mouse button 1 in the shaft away from the scroll box to pull 
it in that direction. This moves the scroll box and view contents by increments 
of the view width or height. 

• Click or hold down a scroll button to pull the scroll box in the direction of the 
scroll button. This moves the scroll box and view contents by increments of the 
line height or character width. 

Generally, use an IViewPort part for a view with scroll bars. Use an IScrollBar part 
for custom logic that requires a scrollable view. 
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Building Guidelines - IScrollBar 

When building with an IScrollBar part, you can do the following: 

• Add a scroll bar to a canvas. Do this by dropping an IScrollBar part on the 
canvas. Then, position and size the scroll bar to fit the canvas. 

• Change the scroll bar orientation to horizontal. Do this by setting the vertical 
field to On and the horizontal field to Off on the IScrollBar Styles settings 
page. 


Attributes - IScrollBar 

Figure 115 (Page 1 of 2). Attributes - IScrollBar. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidiSupported 


Boolean 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

defaultPushButton 


IWindowHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


IWindowHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

horizontal 


Boolean 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

menu 



messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

minScrollIncrement 

■ 

unsigned long 

nativeRect 


IRectangle 

owner 

■ 

I Window* 

pageScrollIncrement 

■ 

unsigned long 

parent 

■ 

I Window* 

parentSize 


ISize 

pointerCaptured 


Boolean 
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Figure 115 (Page 2 of 2). Attributes ■ 

■ IScrollBar. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

scrollableRange 

■ 


IRange 

scrollBoxPosition 

■ 

■ 

unsigned long 

scrollBoxRange 



IRange 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

systemScrollBarWidth 



unsigned long 

systemScrollBoxLength 



unsigned long 

systemScrollButtonLength 



unsigned long 

tabStop 

■ 


Boolean 

valid 



Boolean 

vertical 



Boolean 

visible 

■ 

■ 

Boolean 

visibleCount 

■ 


unsigned long 

visibleRectangle 



IRectangle 


Actions - IScrollBar 

Figure 116 (Page 1 of 2). Actions - IScrollBar 


Action Parameters 


applyBidiSettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh=tme 

Boolean captur e=true 

con vertT oGUIS ty le 

IBitFlag& style 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly= false 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enable d=true 

enableUpdate 

Boolean enableWindow=tme 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

IEvent& exceptionEvent 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

IWindowHandle& siblingWindow 

positionBehindSiblings 

positionOnSiblings 

postEvent 

unsigned long eventld 
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Figure 116 (Page 2 of 2). Actions - IScrollBar 

Action 


refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledB ackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

setScrollBar 

show 

showSourceEmphasis 


Parameters 

IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
IRange& scrollableRange 
unsigned long visibleCount 
Boolean visible= true 
Boolean show=t rue 


Events - IScrollBar 

Figure 117. Events - IScrollBar 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIB LETRUEID 
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General Settings - IScrollBar 

Name 

Sets the name of the part. 

Default value: The name of the part 
Lower 

Sets the length of the scroll bar. 

Default value: 0 
Upper 

Sets the width of the scroll bar. 

Default value: 0 
Visible Count 

Sets the amount of the scrollable range that is displayed. 

Default value: 25 
Scroll box position 

Sets the current position of the scroll bar. 

Default value: 1 
Color selection 

Sets the minimum amount of the scrollable range that the user can scroll by 
selecting the scroll buttons. 

Default value: 1 

Page scroll increment 

Sets the amount of the scrollable range that is scrolled by selecting the scroll shaft. 

Default value: 24 
Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 
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Control Settings - IScrollBar 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IScrollBar 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
autoSize 

Enables automatic sizing of the scroll bar. For a vertical scroll bar, the width is 
determined. For a horizontal scroll bar, the height is determined. 

Default value: The Default radio button is selected. 

horizontal 

Creates a horizontal scroll bar. This style is ignored if it is used with vertical. 

A deck of child windows is arranged in the canvas horizontally in rows from left to 
right. Decks of rows are arranged from top to bottom. 

Default value: The default is off, and the Default radio button is selected. 

vertical 

Creates a vertical scroll bar. This style is used if both it and horizontal are 
specified. 
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A deck of child windows is arranged in the canvas vertically in columns from top 
to bottom. Decks of columns are arranged from left to right. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 
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Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IScrollBar 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 
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Color Settings - IScrollBar 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Highlighted foreground 

Sets the foreground color for selected text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the scroll bar. 

Default value: Red=204, Green=204, Blue=204 


Size/Position Settings - IScrollBar 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
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Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - IScrollBar 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
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Default font 

Sets the current default font style. 
Default value: Not highlighted 
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Chapter 43. ISetCanvas 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM canvas control with child windows set in decks 

ISetCanvas 

ICanvas 

Visual part 

vbbase.vbb 


PushButtonl PushButton2 


An ISetCanvas part is a set of cells organized in rows or columns. These rows or 
columns are called decks. 

The user interacts with controls placed in the cells, not with the canvas itself. 

Use an ISetCanvas part to provide adjustable cells in rows or columns within a 
framework, such as one of the following: 

• The client area of a frame window 

• A view port 

• A multicell canvas cell 

• A split canvas pane 

• A notebook page 

You can then place other controls in the cells of the set canvas. For example, you 
can easily arrange a field of push buttons in the cells of a set canvas. 

You can also use a set canvas as the base part for a composite part. Then, you can 
add the canvas with its controls as a subpart on a canvas in another composite part. 

The cells in a set canvas are adjusted for varying control text length. This enhances 
national language support. 

Alternatively, use one of the following canvases: 

• ICanvas for a single canvas cell 

• ISplitCanvas for split windows 

• IMultiCellCanvas to provide freely arranged canvas cells 
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Building Guidelines - ISetCanvas 

When building with an ISetCanvas part, you can do the following: 

• Organize the cells in rows or columns. By default, the cells are organized in a 
single row. 

To change the cell orientation to columns, select the vertical setting in the Deck 
orientation field on the ISetCanvas General settings page. 

To change the number of decks (rows or columns), set the Deck count field on 
the ISetCanvas General settings page to the number you want. 

• Place controls in the set canvas. Do this by dropping them on the set canvas. 
Each cell is made large enough to accommodate any static text in the control 
placed in the cell. 

• Align cells across multiple decks to give the appearance of both rows and 
columns. Do this by selecting the Even setting in the Pack type field on the 
ISetCanvas General settings page. 

• Make all cells in a deck the same size. Do this by selecting the Expanded 
setting in the Pack type field on the ISetCanvas General settings page. The 
cells are all the the size of the largest minimum size of controls in the cells. 

• Align the cells in a deck with each other. Do this by selecting the alignment you 
want in the Alignment field on the ISetCanvas General settings page. 

• Add a handler for all parts on the canvas. Do this as follows: 

- Add the handler name and parameters in the Handler list field on the 
ISetCanvas Handlers settings page. 

- Type the .hpp file name for the handler in the Class Editor Required 
include files field. 


Attributes - ISetCanvas 


Figure 118 (Page 1 of 2). Attributes ■ 

■ ISetCanvas. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

alignment 

■ 


Alignment 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

deckCount 

■ 


unsigned long 
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Figure 118 (Page 2 of 2). Attributes ■ 

■ ISetCanvas. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

deckOrientation 

■ 

■ 

DeckOrientation 

defaultPushButton 



IWindowHandle 

disabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frameWindow 



Boolean 

group 

■ 


Boolean 

groupPad 

■ 


unsigned long 

handle 



IWindowHandle 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

margin 

■ 


ISize 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

origDefaultButtonHandle 



IWindowHandle 

owner 

■ 


IWindow* 

packType 

■ 


PackType 

pad 

■ 


ISize 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

valid 



Boolean 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 
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Actions - ISetCanvas 

Figure 119 (Page 1 of 2). Actions - ISetCanvas 

Action Parameters 


applyBidiSettings 


capturePointer 

convertToGUIStyle 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 


BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh^ true 
Boolean capture= true 
IBitFlag& style 
Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc=tme 
Boolean enabled= true 
Boolean enableWindow= true 
IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 

unsigned long lay out Attribute sOn 
unsigned long lay outAttribute sOff 
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Figure 119 (Page 2 of 2). Actions - ISetCanvas 

Action Parameters 

show 

showSourceEmphasis 

Events - ISetCanvas 

Figure 120. Events - ISetCanvas 

Event 

commandEvent 
gotFocusEvent 
inputDisabledEvent 
inputEnabledEvent 
lostFocusEvent 
systemCommandEvent 
visibilityDisabledEvent 
visibilityEnabledEvent 

General Settings - ISetCanvas 

Name 

Sets the name of the part. 

Default value: The name of the part 

Deck orientation 

Sets the current orientation of the deck of child windows. 

Default value: Vertical 
Pack type 

Sets how parts are spaced in decks. 

Default value: Tight 
Text 

Sets the text for the part. 

Default value: The name of the part 

Deck count 

Sets the maximum number of decks used by the canvas. 

Default value: 1 
Width 

Specifies the width of the margin. It is half a character and is based on the current 
font being used for the entry field text. 

Default value: 8 


Notification ID 

commandld 

FOCU STRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


Boolean visible= true 
Boolean show=\me 


Chapter 43. ISetCanvas 373 



Height 

Specifies the height of the margin. It is half a character and is based on the current 
font being used for the entry field text. 

Default value: 10 

Width 

Sets the pad width, which is the space between child windows in a deck and 
between multiple decks. 

Default value: 8 

Height 

Sets the pad height, which is the space between child windows in a deck and 
between multiple decks. 

Default value: 10 

Alignment 

Changes the alignment of the part. 

Default value: Upper left 
Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 


Control Settings - ISetCanvas 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
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Enabled 

Enables the handler by default. 
Default value: Selected 


Styles Settings - ISetCanvas 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
horizontalDecks 

Sets the orientation of the deck of child windows to horizontal. 

Default value: The Default radio button is selected. 
verticalDecks 

Sets the orientation of the deck of child windows to vertical. 

Default value: The Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
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saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - ISetCanvas 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 
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Default value: Not highlighted 


Color Settings - ISetCanvas 

Color area 

Sets the color of the given area. Choices are as follows: 

Background 

Sets the color for background text 

Default value: Background is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the canvas. 

Default value: Red=255, Green=255, Blue=255 


Size/Position Settings - ISetCanvas 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 


Chapter 43. ISetCanvas 377 



Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 


Font Settings - ISetCanvas 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
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Default font 

Sets the current default font style. 
Default value: Not highlighted 
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Chapter 44. ISlider 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM linear slider control 
ISlider 

IProgressIndicator 
Visual part 
vbbase.vbb 


<► 0 


An ISlider part shows a range of selection values. A horizontal or vertical shaft 
represents the range of values. A slider arm marks the selected value. 

The user moves the arm along the shaft to change the selected value. The user can 
move the arm in any of the following ways: 

• Drag it with the mouse. 

• Click or press a slider button to move the scroll box in the direction indicated on 
the button. This moves the arm by tick increments defined for the slider. 

Use an ISlider part to do the following: 

• Provide a range of seemingly nondiscrete selection values, such as shades of 
visual color 

• Provide a range of discrete selection values, such as radio station frequencies 

• Show a value relative to a range of potential values, such as the current 
temperature on a thermometer 


Building Guidelines - ISlider 

When building with an ISlider part, you can do the following: 

• Define the value scale for the slider. Do this as follows: 

- Enter the number of ticks in the Number of ticks field on the ISlider 
General settings page. 

- Select the location of the scale of tick marks and text relative to the slider. 
Do this by selecting a choice in the Primary scale field on the ISlider 
General settings page. If you want the scale above a horizontal slider or to 
the right of a vertical slider, select the Scale 1 choice. If you want the scale 
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below a horizontal slider or to the left of a vertical slider, select the Scale 2 
choice. 

- Add scale tick marks and text to the slider. Do this using custom logic. 

Click mouse button 2 on the free-form surface and connect the composite 
part ready event to ISlider Custom logic. Enter C++ code to set the size and 
text for each tick mark. 

For example, if you want the user to set a rating from 0 to 100 with marks at 
intervals of 10, you could enter the following code: 

for (int i = 0; i < 101; i += 10) 


target->setTickLength(i, 10); 
target->setTickText(i, IString(i)); 

} 


• Determine the orientation of the slider. By default, the orientation is horizontal. 
To orient the slider vertically, set the vertical field to On and set the horizontal 
field to Off on the ISlider Styles settings page. 

• Select the location of slider buttons relative to the slider. Do this by selecting a 
button location choice on the ISlider Styles settings page. If you want slider 
buttons, set one of the following location choices to On and set the others to Off: 


Choice 

buttonsBottom 

buttonsLeft 

buttonsRight 

buttonsTop 


Button location 

Below the slider shaft. 
Left of the slider shaft. 
Right of the slider shaft. 
Above the slider shaft. 


If you do not want slider buttons, set all of the location choices to Off. 


• Define the home position for the slider. Do this by selecting a choice in the 
Home position field on the ISlider General settings page. If you want the home 
position at the left of a horizontal slider or at the bottom of a vertical slider, 
select the Left or bottom choice. If you want the home position at the right of a 
horizontal slider or at the top of a vertical slider, select the Top or right choice. 


• If you want the initial arm offset somewhere other than at the home position, set 
the Arm offset field on the ISlider General settings page. Specify either a tick 
offset for Ticks or a pixel offset for Pixels. 


• Force the arm to the nearest tick if you use a pixel offset. Do this by setting the 
snapToTickMark field to On on the ISlider Styles settings page. 


• Provide the selected value to an attribute in another part or to an action 

parameter. Do this by connecting the ISlider armTickOffset attribute to the target 
attribute or action connection parameter. 
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Attributes - ISlider 


Figure 121 (Page 1 of 2). Attributes 

ISlider. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

alignment 



Alignment 

armPixelOffset 

■ 

■ 

unsigned long 

armRange 



unsigned long 

armSize 

■ 


ISize 

armTickOffset 

■ 

■ 

unsigned long 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObject 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

buttonsPosition 



ButtonsPosition 

characters ize 



ISize 

defaultPushButton 



IWindowHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

drawItemEnabled 

■ 


Boolean 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

homePosition 

■ 


HomePosition 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

primaryScale 

■ 

■ 

Scale 

rect 

■ 


IRectangle 

ribbonStripEnabled 

■ 


Boolean 

shadowColor 

■ 

■ 

IColor 

shaftPosition 

■ 


IPoint 
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Actions 


Figure 121 (Page 2 of 2). Attributes -1Slider. 

(S is Set, E is Event) 

Attribute S 

E 

Data type 

shafts ize 


ISize 

showing 


Boolean 

size ■ 

■ 

ISize 

snapToTickEnabled ■ 


Boolean 

tabStop ■ 


Boolean 

valid 


Boolean 

vertical 


Boolean 

visible ■ 

■ 

Boolean 

visibleRectangle 


IRectangle 


ISlider 

Figure 122 (Page 1 of 2). Actions - ISlider 


Action 

Parameters 

addDetent 

unsigned long offset 

applyBidiSettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh^ true 

Boolean capture=tm& 

convertToGUIStyle 

IBitFlag& style 

detentPosition 

Boolean extendedOnly= false 
unsigned long detentld 

disable 

disableDrawItem 

disableGroup 

disableNotification 

disableRibbonStrip 

disableSnapToTick 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow= true 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

IEvent& exceptionEvent 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

numberOfTicks 

Scale scale 

positionBehindSibling 

IWindowHandle& siblingWindow 

positionBehindSiblings 

positionOnSiblings 

postEvent 

unsigned long eventld 

refresh 

IEventParameter 1 & parml=0 

IEventParameter2& parm2= 0 

IRectangle& invalidRectangle 
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Figure 122 (Page 2 of 2). Actions - ISlider 

Action 

releasePointer 

releasePresSpace 

removeDetent 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

setShaftBreadth 

setTickLength 

setTicks 


setTickText 

show 

showSourceEmphasis 

tickLength 

tickPosition 

tickSpacing 

tickText 


Parameters 


IPresSpaceHandle& presentationSpaceHandle 
unsigned long detentld 


unsigned long eventld 
IEventParameterl& parml= 0 
IEventParameter2& parm2= 0 

unsigned long layoutAttributesOn 
unsigned long layoutAttributesOff 
unsigned long breadth 
unsigned long tickNumber 
unsigned long length 
unsigned long scaleINumberOfTicks 
unsigned long scale2NumberOjTicks 
unsigned long scalelTickSpacing= 0 
unsigned long scale2TickSpacing=0 
unsigned long tickNumber 
char* text 

Boolean visible= true 
Boolean show= true 
unsigned long tickNumber 
unsigned long tickNumber 
Scale scale 

unsigned long tickNumber 


Events - ISlider 

Figure 123 (Page 1 of 2). Events - ISlider 

Event Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

scaleEvent 

systemCommandEvent 

visibilityDisabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

scaleld 

systemCommandld 

VISIBLEFALSEID 
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Figure 123 (Page 2 of 2). Events - ISlider 

Event Notification ID 

visibilityEnabledEvent VISIBLETRUEID 


General Settings - ISlider 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Number of ticks 

Sets the number of ticks. 

Default value: 2 
Tick spacing 

Sets the number of pixels between ticks for the specified scale. 

Default value: None 
Ticks 

Sets the position of the arm as a tick number. Ticks are numbered starting at zero. 

Default value: 0 
Pixels 

Sets the offset of the arm from the home position. 

Default value: 0 
Home position 

Sets the home position of the progress indicator. 

Default value: Left or bottom 
Primary scale 

Sets the primary scale of the progress indicator. 

Default value: Scale 1 


Control Settings - ISlider 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
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Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - ISlider 

defaultStyle() 

Resets the part to the original default style. 

Default value: Selected 
buttonsTop 

Aligns the push buttons with the top side of the part. 

Default value: The Default radio button is selected. 

buttonsBottom 

Aligns the push buttons with the bottom side of the part. 

Default value: The Default radio button is selected. 

buttonsLeft 

Aligns the push buttons with the left side of the part. 

Default value: The Default radio button is selected. 

buttonsRight 

Aligns the push buttons with the right side of the part. 

Default value: The Default radio button is selected. 

horizontal 

Creates a horizontal scroll bar. This style is ignored if it is used with vertical. 

A deck of child windows is arranged in the canvas horizontally in rows from left to 
right. Decks of rows are arranged from top to bottom. 

Default value: The default is off, and the Default radio button is selected. 

snapToTickMark 

Specifies that the progress indicator arm snap to the nearest tick when moved 
between two ticks. 
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Default value: The Default radio button is selected. 

ribbonStrip 

Sets the default ribbonStrip style. 

Default value: The Default radio button is selected. 

handleDrawItem 

Generates a draw item event to allow the application to draw the part. 

Default value: The Default radio button is selected, 
vertical 

Creates a vertical scroll bar. This style is used if both it and horizontal are 
specified. 

A deck of child windows is arranged in the canvas vertically in columns from top 
to bottom. Decks of columns are arranged from left to right. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 
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clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - ISlider 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 


Chapter 44. ISlider 389 



Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ISlider 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Border 

Sets the color of the border drawn around the children of the frame window. 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Size/Position Settings - ISlider 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - ISlider 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 45. ISplitCanvas 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM canvas divided into resizable panes 

ISplitCanvas 

ICanvas 

Visual part 

vbbase.vbb 



An ISplitCanvas part is a split window in which view ports or canvases can be 
placed. A split bar appears between panes in the split canvas. 

The user can move the split bar by pressing mouse button 2 on it and dragging it. 

Use an ISplitCanvas part to provide split windows within a framework, such as one 
of the following: 

• The client area of a frame window 

• A multicell canvas cell 

• A notebook page 

You can then place another canvas or a view port in each pane of the split window. 

You can also use a split canvas as the base part for a composite part. Then, you can 
add the canvas with its controls as a subpart on a canvas in another composite part. 

Alternatively, use one of the following canvases: 

• ICanvas for a single canvas cell 

• ISetCanvas for canvas cells in uniform rows or columns 

• IMultiCellCanvas to provide freely arranged canvas cells 
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Building Guidelines - ISplitCanvas 

When building with an ISplitCanvas part, you can do the following: 

• Assign the split canvas to the client area of a frame window. Do this as follows: 

1. Remove an existing client from the frame window by clicking mouse 
button 2 on the client area and selecting the Delete choice. 

2. Select an ISplitCanvas part from the parts palette and drop it on the frame 
window client area. The client area is initially filled with a primitive part. 

• Create and fill the panes of the split window. Each pane should be filled with a 
canvas or a view port. For example, to create three panes with view ports in 
them, do the following: 

1. Drop a view port on the primitive part. A split bar and two panes appear, 
with the view port in the first pane. 

2. Drop a view port on the primitive part or on the split bar. The new view 
port replaces the primitive part in the second pane. 

3. Drop a view port on the split bar. A second split bar and third pane appear, 
with the new view port in the third pane. 

• Change the window orientation to split horizontally. Do this by selecting the 
horizontal setting in the Orientation field on the ISplitCanvas General settings 
page. To open the settings view for a split canvas after panes have been created, 
click mouse button 2 on a split bar. 

• Add a handler for all parts on the canvas. Do this as follows: 

- Add the handler name and parameters in the Handler list field on the 
ISplitCanvas Handlers settings page. 

- Type the .hpp file name for the handler in the Class Editor Required 
include files field. 


Attributes - ISplitCanvas 

Figure 124 (Page 1 of 2). Attributes - ISplitCanvas. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 
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Figure 124 (Page 2 of 2). Attributes - ISplitCanvas. (S is Set, E is Event) 


Attribute S E Data type 


defaultPushButton 


IWindowHandle 

disabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


IWindowHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

itemProvider 

■ 

IDMItemProvider* 

layoutAdjustment 

menu 


IRectangle 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

orientation 

■ ■ 

Orientation 

origDefaultButtonHandle 


IWindowHandle 

owner 

■ 

IWindow* 

parent 

■ 

IWindow* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

splitBarEdgeColor 

■ 

IColor 

splitBarMiddleColor 

■ 

IColor 

tabStop 

■ 

Boolean 

valid 


Boolean 

visible 

■ ■ 

Boolean 

visibleRectangle 


IRectangle 
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Actions - ISplitCanvas 

Figure 125 (Page 1 of 2). Actions - ISplitCanvas 

Action Parameters 


applyBidiSettings 


capturePointer 

convertToGUIStyle 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledB ackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

resetSplitBarEdgeColor 

resetSplitBarMiddleColor 

sendEvent 


setFocus 


BidiSettings& settings 
Boolean childlnherit= true 
Boolean refresh^ true 
Boolean capture= true 
IBitFlag& style 
Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc=tme 
Boolean enabled= true 
Boolean enableWindow= true 
IException& dispatcherException 
IEvent& exceptionEvent 


unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
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Figure 125 (Page 2 of 2). Actions - ISplitCanvas 

Action Parameters 

setLayoutDistorted unsigned long layoutAttributesOn 

unsigned long layoutAttributesOjf 
setSplitBarThickness SplitBarArea area 

unsigned long thickness 

setSplitWindowPercentage Window* window 

unsigned long percentage 

show Boolean visible= true 

showSourceEmphasis Boolean show= true 

splitBarThickness SplitBarArea area 

splitWindowPercentage Window* window 

Events - ISplitCanvas 

Figure 126. Events - ISplitCanvas 

Event 

commandEvent 
gotFocusEvent 
inputDisabledEvent 
inputEnabledEvent 
lostFocusEvent 
systemCommandEvent 
visibilityDisabledEvent 
visibilityEnabledEvent 

General Settings - ISplitCanvas 

Name 

Sets the name of the part. 

Default value: The name of the part 

Orientation 

Sets the current orientation of the canvas. 

Default value: Vertical 
Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 


Notification ID 

commandld 
FOCU STRUEID 
ENABLEFALSEID 
ENABLETRUEID 
FOCU SFALSEID 
systemCommandld 
VISIBLEFALSEID 
VISIBLETRUEID 
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Control Settings - ISplitCanvas 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - ISplitCanvas 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
horizontal 

Creates a horizontal scroll bar. This style is ignored if it is used with vertical. 

A deck of child windows is arranged in the canvas horizontally in rows from left to 
right. Decks of rows are arranged from top to bottom. 

Default value: The default is off, and the Default radio button is selected. 

vertical 

Creates a vertical scroll bar. This style is used if both it and horizontal are 
specified. 

A deck of child windows is arranged in the canvas vertically in columns from top 
to bottom. Decks of columns are arranged from left to right. 

Default value: The default is on, and the Default radio button is selected. 
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noSplitBars 

If specified, the split canvas has no split bars. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Chapter 45. ISplitCanvas 399 



Handlers Settings - ISplitCanvas 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ISplitCanvas 

Color area 

Sets the color of the given area. Choices are as follows: 

SplitBarEdgeColor 

Sets the top and bottom edges of a horizontal split bar or the left and right 
edges of a vertical split bar. 

SplitBarMiddleColor 

Sets the middle of the split bar. 

Default value: Background is selected 
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Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: Dark gray 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - ISplitCanvas 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 


Chapter 45. ISplitCanvas 401 



Width 

Sets the minimum-allowable width, which is set by the user’s class. 
Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 
Default value: None (calculated at execution time) 


Font Settings - ISplitCanvas 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 46. IStaticText 

IBM static text control 
IStaticText 
ITextControl 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


StaticTextl 


An IStaticText field part is a textual or graphical label. The user cannot modify a 
static text field. 

Use an IStaticText part to do the following: 

• Display status information to the user 

• Provide a label for a control 


Building Guidelines - IStaticText 

When building with an IStaticText part, you can do the following: 

• Define a label for a control. Do this by entering the label you want in the Text 
field on the IStaticText General settings page. 

• Customize the appearance of a label. Do this by selecting choices on the 
IStaticText Color and Font settings pages. If you placed the IStaticText part on 
an ISetCanvas part or on an IMultiCellCanvas part, the static text part is 
dynamically expanded for font changes if more space is required. 

• Provide instructions for a field. Do this by entering the instructions in the Text 
field on the IStaticText General settings page. Select the upper-left choice in the 
Alignment field and select the Word wrap choice to extend instructions to 
multiple lines. 

• Display a block of color with no text. Do this by clearing the Text field on the 
IStaticText General settings page and selecting a fill color on the IStaticText 
Color settings page. Set the color by selecting the Fill Color area choice and 
either selecting a choice from the Colors list or specifying the RGB values you 
want. 

• Provide changing information, such as the date. Show the date as follows: 

1. Add an IDate part to the free-form surface. 
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2. Press mouse button 2 on the IDate part and select the Tear-Off Attribute 
choice. 

3. Select the today attribute. A today IVBVariable is added to the free-form 
surface and connected to the IDate part. 

4. Connect the today variable asString attribute to the IStaticText text attribute. 


Attributes - IStaticText 

Figure 127 (Page 1 of 2). Attributes - IStaticText. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

alignment 

■ 

Alignment 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

characterSize 


ISize 

clipboardHasTextFormat 


Boolean 

defaultPushButton 


IWindowHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

displaySize 


ISize 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

fillBackground 

■ ■ 

Boolean 

fillColor 

■ ■ 

IColor 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

halftone 

■ ■ 

Boolean 

handle 


IWindowHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

limit 

■ ■ 

unsigned long 

menu 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

owner 

■ 

I Window* 

parent 

■ 

I Window* 
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Figure 127 (Page 2 of 2). Attributes 

IStaticText. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

strikeout 

■ 

■ 

Boolean 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

underscore 

■ 

■ 

Boolean 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IStaticText 


Figure 128 (Page 1 of 2). Actions - IStaticText 


Action 

Parameters 

applyBidiSettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit=\me 

Boolean refresh^ true 

Boolean capture=tme 

con vertT oGUIS ty le 

IBitFlag& style 

disable 

disableFillBackground 

disableGroup 

disableHalftone 

disableNotification 

disableStrikeout 

disableTabStop 

disableUnderscore 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly=fa\se 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tme 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

IEvent& exceptionEvent 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 
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Figure 128 (Page 2 of 2). Actions - IStaticText 

Action 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledB ackgroundColor 

resetDisabledForegroundColor 

resetFillColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 


Parameters 

INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & parml=0 
IEventParameter2& parm2= 0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
Boolean visible= true 
Boolean show=t rue 


Events - IStaticText 

Figure 129. Events - IStaticText 

Event Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 
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General Settings - IStaticText 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

Limit 

Sets the length (in bytes) of the longest text the part can hold. 
Default value: 32 
Alignment 

Changes the alignment of the part. 

Default value: Upper left 
Word wrap 

Enables word wrap of text around at the end of a line. 

Default value: Not selected 


Control Settings - IStaticText 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 
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Styles Settings - IStaticText 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
mnemonic 

Draws the next character with mnemonic emphasis if a mnemonic prefix character 
is found. 

Default value: The Default radio button is selected. 

fillBackground 

Erases the background, using the currently set fill color before drawing the text. 
Default value: The default is on, and the Default radio button is selected. 

halftone 

Draws the text in halftone color. 

Default value: The default is off, and the Default radio button is selected. 

underscore 

Draws the text with underscoring. 

Default value: The default is off, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 
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clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IStaticText 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 
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Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IStaticText 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text that surrounds the part 

Fill 

Sets the color for the area of the part that is not occupied by text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the static text. 

Default value: Red=0, Green=0, Blue=170 
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Size/Position Settings - IStaticText 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IStaticText 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 47. ITextSpinButton 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM text spin-button control 

ITextSpinButton 

IBaseSpinButton 

Visual part 

vbbase.vbb 



An ITextSpinButton part is a ring of text choices. One choice is visible at a time. 

The user can spin the ring upward or downward to select another choice. 

Use an ITextSpinButton part to provide, in sequence, a ring of related but mutually 
exclusive text choices. For example, use a spin button for a selection list of the 
months of the year. 

Alternatively, use an INumericSpinButton part for a ring of numeric choices. 


Building Guidelines - ITextSpinButton 

When building with an ITextSpinButton part, you can do the following: 

• Define the initial string choices for the spin button. Do this by entering the 
strings in the Contents field on the ITextSpinButton General settings page. 

• Define a default selection for the spin button. Do this by entering one of the 
strings from the Contents field in the Text field on the ITextSpinButton General 
settings page. 

• Prevent the user from typing a choice. Do this by setting the Read only field on 
the ITextSpinButton Styles settings page. 

• Make the spin button skip values to cycle faster when the user continues to spin 
the button. Do this by setting the Fast spin field on the ITextSpinButton Styles 
settings page. 

• Copy the selection from the spin button to a text field. Do this by connecting the 
ITextSpinButton text attribute to the target text field. 
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Attributes - ITextSpinButton 

Figure 130 (Page 1 of 2). Attributes - ITextSpinButton. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

alignment 

■ 

Alignment 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

border 


Boolean 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

defaultPushButton 


IWindowHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

fastSpinEnabled 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


IWindowHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

limit 

■ 

unsigned long 

master 


Boolean 

menu 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

owner 

■ 

I Window* 

parent 

■ 

I Window* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

servant 


Boolean 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

spinField Valid 


Boolean 

tabStop 

■ 

Boolean 
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Actions 


Figure 130 (Page 2 of 2). Attributes ■ 

■ ITextSpinButton. 


(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

text 

■ 

■ 

IString 

textLength 


■ 


valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 

writeable 

■ 


Boolean 


ITextSpinButton 

Figure 131 (Page 1 of 2). Actions ■ 

■ ITextSpinButton 

Action 

Parameters 

add 

IResourceId& item 
unsigned long index 

addAsFirst 

IResourceId& item 

addAsLast 

IResourceId& item 

addB order 

Boolean add= true 

applyBidiSettings 

BidiSettings& settings 

Boolean childlnherit= true 

Boolean refresh=tme 

capturePointer 

Boolean capture=tm& 

con vertT oGUIS ty le 

disable 

disableDataUpdate 

disableFastSpin 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

IBitFlag& style 

Boolean extendedOnly=fa\se 

dispatchRemainingHandlers 

IEvent& event 

Boolean callDefProc= true 

elementAt 

unsigned long index 

enable 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tme 

handleException 

hide 

hideSourceEmphasis 

IException& dispatcherException 

IEvent& exceptionEvent 

isLayoutDistorted 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

IWindowHandle& siblingWindow 

postEvent 

unsigned long eventld 

IEventParameterl& parml- 0 
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Figure 131 (Page 2 of 2). Actions - ITextSpinButton 

Action Parameters 


refresh 

releasePointer 

releasePresSpace 

removeAll 

removeB order 

resetActiveColor 

resetB ackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

setMaster 

show 

showSourceEmphasis 

spinDown 

spinTo 

spinUp 


IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
IBaseSpinButton& master 
Boolean visible=tme 
Boolean show= true 
unsigned long spinBy= 1 
unsigned long index 
unsigned long spinBy= 1 


Events - ITextSpinButton 

Figure 132. Events - ITextSpinButton 

Event Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

textEvent 

valueEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

textld 

valueld 

VISIBLEFALSEID 

VISIBLETRUEID 
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General Settings - ITextSpinButton 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Alignment 

Changes the text alignment of the part. Left aligns the text to the left. Center 
centers the text, and Right aligns the text at the right. 

Default value: Left 

Text 

Sets the text for the part. 

Default value: The name of the part 

Contents 

Sets initial items for the part. 

Default value: None 


Control Settings - ITextSpinButton 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 

Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 
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Styles Settings - ITextSpinButton 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
readonly 

Prevents entering input into the field. 

Default value: The default is off, and the Default radio button is selected. 

noBorder 

Suppresses the drawing of a border. 

Default value: The Default radio button is selected. 

Fast spin 

Increases the spin speed of the part. 

Default value: Not selected 
master 

Specifies that the spin button component consists of: 

• One or more single-line entry fields (SLE) or spin fields 

• Two arrows—the Up arrow and the Down arrow 

When a spin button contains more than one spin field, the master component 
contains the spin arrows. If the component contains only one spin field, it must be 
the master. 

Default value: The default is on, and the Default radio button is selected, 
servant 

Allows the user to create a multiple-field spin button by spinning servants from the 
master. 

Default value: The default is off, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 
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clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 
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Handlers Settings - ITextSpinButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - ITextSpinButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Disabled foreground 

Sets the foreground color for disabled text 

Border 

Sets the color of the border that surrounds the part. 
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Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 


Size/Position Settings - ITextSpinButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 
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Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 
Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 
Default value: None (calculated at execution time) 


Font Settings - ITextSpinButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 48. ITitle 

Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM window-title text-control 
ITitle 

ITextControl 
Nonvisual part 
vbbase.vbb 


fM-lc 


Titlel 


An ITitle part is a frame window title control. The title can be changed after the 
window is created. 

The user can change the title if your application provides the capability through other 
controls. Otherwise, the user can only observe title changes made by your 
application. 

Use an ITitle part to change a frame window title. 


Building Guidelines - ITitle 

When building with an ITitle part, you can do the following: 

• Add a changeable title to a frame window. Do this by selecting an ITitle part 
from the parts palette and dropping it on the free-form surface. 

• Identify the frame window that the title is related to. If you have only one frame 
window in your view, the title is automatically related to that frame window. 

If you want the title for a second frame window in your view, do this by 
referencing the frame window Subpart name, which appears on its General 
settings page. Enter the frame window subpart name, prefixed with “i,” in the 
Owner field on the General settings page of the ITitle part. 

• Define an initial title. Do this by defining title fields on the ITitle General 
settings page: 

- Enter the object name or desired title in the Object text field. 

- Optionally, enter the view name in the View text field. 

- Optionally, enter the view number in the View number field. 
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• Change the title when an event occurs. Do this as follows: 

- Connect the event to the ITitle setTitleText action. 

- Open settings for the connection, press the Set parameters push button, and 
enter the title in the objectName parameter. You can optionally specify 
viewName and viewNum parameters for the title. 

• Provide the title from one or more attributes of other parts. Do this as follows: 

- Connect a text attribute to the ITitle objectText attribute. 

- Optionally, connect a text attribute to the ITitle viewName attribute. 

- Optionally, connect a numeric attribute to the ITitle viewNumber attribute. 


Attributes - ITitle 


Figure 133 (Page 1 of 2). Attributes - ITitle. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

activeTextBackgroundColor 

■ 

■ 

IColor 

acti veT extF oregroundColor 

■ 

■ 

IColor 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroy Window 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

defaultPushButton 



IWindowHandle 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



IWindowHandle 

hiliteBackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

inactiveT extBackgroundColor 

■ 

■ 

IColor 

inactiveT extF oregroundColor 

■ 

■ 

IColor 

isDigits 


■ 


itemProvider 

■ 


IDMItemProvider* 

lay out Adjustment 



IRectangle 

menu 




messageQueue 



IMessageQueueHandle 
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Figure 133 (Page 2 of 2). Attributes ■ 

■ ITitle. (S is Set, E is Event) 

Attribute 

s 

E 

Data type 

minimumSize 

■ 


ISize 

nativeRect 



IRectangle 

objectText 

■ 

■ 

IString 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parentSize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


viewNum 

■ 


unsigned long 

viewNumber 

■ 

■ 

unsigned long 

viewText 

■ 

■ 

IString 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - ITitle 


Figure 134 (Page 1 of 2). Actions - ITitle 


Action 

Parameters 

apply B idi S ettings 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh= true 

Boolean captur e=true 

con vertT oGUIS ty le 

IBitFlag& style 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

Boolean extendedOnly=fa\se 

IEvent& event 

enable 

Boolean callDefProc= true 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tme 

handleException 

IException& dispatcherException 

hide 

hideSourceEmphasis 

IEvent& exceptionEvent 
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Figure 134 (Page 2 of 2). Actions - ITitle 

Action 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetActiveT extBackgroundColor 
r eset Acti veT extF or eground Color 

resetB ackgroundColor 
resetBorderColor 
resetDisabledB ackgroundColor 
resetDisabledForegroundColor 
resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 

resetlnactiveTextBackgroundColor 
resetlnactiveT extF oregroundColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

setTitleText 


show 

showSourceEmphasis 


Parameters 

unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IE ventParameter 1 & pa rm 1 =0 
IEventParameter2& parm2= 0 

unsigned long lay outAttribute sOn 
unsigned long lay outAttribute sOff 
char* objectName 
char* viewName- 0 
unsigned long viewNum= 0 
Boolean visible=tme 
Boolean show=t rue 
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Events - ITitle 

Figure 135. Events - ITitle 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


General Settings - ITitle 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Owner 

Sets the window’s owner. 

Default value: None 
Object text 

Sets the initial title text. 

Default value: None 
View text 

Sets the name of the view for the title bar. 

Default value: None 
View number 

Sets the number of the view for the title bar. 

Default value: None 
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Chapter 49. IToolBar 

IBM tool-bar control 
IToolBar 
ISetCanvas 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


□ 


□ I 


An IToolBar part is a set of tool function buttons. The tool bar is initially located 
adjacent to the client area of the frame window it is related to. 

The user can click the tool bar buttons to perform the tool functions. The user can 
also drag the tool bar away from the frame window. 

Use an IToolBar part to give the user a set of tool functions. 


Building Guidelines - IToolBar 

When building with an IToolBar part, you can do the following: 

• Add a tool bar to a frame window. Do this by selecting an IToolBar part from 
the parts palette and dropping it on the frame window. The tool bar is placed in 
a frame extension at the top of the client area. One IToolBarButton part is 
automatically placed on the tool bar. 

• Group a second tool bar with one previously added to the frame window. Do 
this by selecting the Group with preceding tool bar field on the General 
settings page of the second IToolBar part. The tool bar is moved to the same 
row or column as the first tool bar and placed after the first tool bar. 

• Change the location of the tool bar. Do this by selecting a location choice from 
the Location field on the IToolBar General settings page. If the tool bar is 
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placed above or below the client area, its orientation is horizontal. If it is placed 
to the left or right of the client area, its orientation is vertical. 

• Hide the tool bar. Do this by selecting the Hidden choice from the Location 
field on the IToolBar General settings page. 

• Define title bar text to be displayed with the tool bar when the user drags it away 
from the frame window. Do this by entering text in the Floating title field on 
the IToolBar General settings page. 


Attributes - IToolBar 

Figure 136 (Page 1 of 2). Attributes - IToolBar. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

alignment 

■ 

Alignment 

allowsDragDrop 


Boolean 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroy Window 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

button View 

■ 

IToolB arB utton:: V ie w 

characters ize 


ISize 

deckCount 

■ 

unsigned long 

deckOrientation 

■ ■ 

DeckOrientation 

defaultGroupPad 

■ 

unsigned long 

defaultMargin 

■ 

ISize 

defaultMisfitWidth 

■ 

unsigned long 

defaultPad 

■ 

long 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

expanded 


Boolean 

floatingFrame 


IToolB arFrame Windo w * 

floatingPosition 

■ 

IPoint 

floatingTitle 

■ 

IString 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

groupPad 

■ 

unsigned long 

handle 


I Windo wHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 
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Figure 136 (Page 2 of 2). Attributes - IToolBar. (S is Set, E is Event) 

Attribute 

S E 

Data type 

itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

location 

■ 

Location 

margin 

■ 

ISize 

menu 



messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

misfitFilteringEnabled 

■ 

Boolean 

nativeRect 


IRectangle 

origDefaultButtonHandle 


IWindowHandle 

owner 

■ 

Window* 

packType 

■ 

PackType 

pad 

■ 

ISize 

parent 

■ 

IWindow* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

tabS top 

■ 

Boolean 

text 

■ ■ 

IString 

toolBarContainer 


IToolB arContainer * 

valid 


Boolean 

visible 

■ ■ 

Boolean 

visibleRectangle 


IRectangle 


Actions - IToolBar 


Figure 137 (Page 1 of 3). Actions - IToolBar 


Action 

Parameters 

addAsFirst 

IWindow* window 

addAsLast 

Boolean startNewGroup= false 

IWindow* window 

addAsNext 

Boolean startNewGro «/?=false 

IWindow* window 

addAsPrevious 

IWindow* referenceWindow 

Boolean startNewGroup= false 

IWindow* window 

applyBidiSettings 

IWindow* referenceWindow 

Boolean startNewGroup=fa\se 

BidiSettings& settings 

capturePointer 

Boolean childlnherit= true 

Boolean refresh=\me 

Boolean capture= true 

collapse 

convertToGUIStyle 

IBitFlag& style 
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Figure 137 (Page 2 of 3). Actions - IToolBar 

Action 


disable 

disableDragDrop 

disableGroup 

disableMisfitFiltering 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableDragDrop 

enableUpdate 

expand 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

moveAfter 


moveBefore 


moveToFirst 

moveToLast 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

remove 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteBackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 


Parameters 

Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enable= true 
Boolean enableWindow= true 
Boolean expand= true 
IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long lay out Attribute 
unsigned short character 
IWindow* window 
IWindow* referenceWindow 
Boolean startNewGroup- false 
IWindow* window 
IWindow* referenceWindow 
Boolean startNewGroup= false 
IWindow* window 
Boolean startNewGroup= false 
IWindow* window 
Boolean startNewGroup=fa\se 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 
IWindow* window 
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Figure 137 (Page 3 of 3). Actions - IToolBar 

Action Parameters 


resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 


unsigned long eventld 
IEventParameterl& parml =0 
IEventParameter2& parm2 =0 

unsigned long lay outAttribute sOn 
unsigned long layoutAttributesOff 
Boolean visible= true 
Boolean show= true 


Events - IToolBar 

Figure 138. Events - IToolBar 

Event Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


General Settings - IToolBar 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Floating title 

Sets the title text of the floating frame window. 

Default value: None 
Group with preceding tool bar 

Specifies that the tool bar should be grouped with the preceding tool bar. 
Default value: Not selected 
Location 

Sets the location of the tool bar. 

Default value: The first item in the list is selected. 
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Control Settings - IToolBar 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IToolBar 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
buttonBitmapVisible 

Sets the the style so that the bitmap is displayed. 

Default value: The Default radio button is selected. 

buttonTextVisible 

Sets the the style so that text is displayed. 

Default value: The Default radio button is selected. 

buttonBitTextVisible 

Sets the the style so that both the bitmap and text are displayed. 

Default value: The Default radio button is selected. 

noDragDrop 

Disables the dragging of a tool bar, the objects that reside within the tool bar (such 
as a tool bar button), and drops on the tool bar buttons. 
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Default value: The Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 

filterMisfits 

Sets the style so that misfits are filtered in or out based on the orientation of the 
tool bar and the current tool bar style. 

Default value: The Default radio button is selected. 
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Handlers Settings - IToolBar 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IToolBar 

Color area 

Sets the color of the given area. Choices are as follows: 

Background 

Sets the color for background text 

Default value: Background is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 
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Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the canvas. 

Default value: Red=255, Green=255, Blue=255 


Size/Position Settings - IToolBar 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Height 

Sets the minimum-allowable height, which is set by the user’s class. 
Default value: None (calculated at execution time) 


Font Settings - IToolBar 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 50. IToolBarButton 


IBM tool-bar button control 

IToolBarButton 

ICustomButton 

Visual part 

vbbase.vbb 



Title: 

Class name: 
Base part: 
Part type: 
Part file: 


An IToolBarButton part is a selection button for a tool bar function. The choice is 
identified by a graphic on the tool bar button. 

The user can click the tool bar button to perform the indicated function. 

Use an IToolBarButton part to give the user a function choice for a tool bar. 


Building Guidelines - IToolBarButton 

When building with an IToolBarButton part, you can do the following: 

• Use a predefined button. Do this by setting the Select from type list field and 
selecting a button identifier from the Type list field for Predefined button types 
on the IToolBarButton General settings page. A predefined bitmap is placed on 
the button. 

• Assign a bitmap to the tool bar button. Do this by entering a DLL name and a 
Resource ID for the Bitmap field on the IToolBarButton General settings page. 

• Give the button the appearance of remaining latched down while it is active. Do 
this by setting the latchable field on the IToolBarButton Styles settings page. 

• Allow the user to reach the button by using a tab key. Do this by setting the 
tabStop field to On on the IToolBarButton Styles settings page. 

• If the button is the first control in a group, allow the user to use cursor keys to 
move between the button and follow controls in the group. Do this by setting the 
group field to On on the IToolBarButton Styles settings page. This field is 
initially set for the tool bar button automatically placed on an IToolBar part when 
it is added to a frame window. 

• Start the action represented by the button. Do this by connecting the 
IToolBarButton buttonClickEvent feature to the action on the target part. 
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• Enable or disable the tool bar button when an event occurs. 

Enable the button as follows: 

1. Connect the event to the IToolBarButton enable action. 

2. The button is enabled by default. If you have changed this default, open 
settings for the connection, press the Set parameters push button, and check 
the Enabled setting. 

Disable the button by connecting the event to the IToolBarButton disable action. 


Attributes - IToolBarButton 


Figure 139 (Page 1 of 2). Attributes 

IToolBarButton. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

allowsDragDelete 



Boolean 

allowsMouseClickFocus 

■ 


Boolean 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObj ect 

■ 


Boolean 

autoDestroy Window 

■ 


Boolean 

autoLatchEnabled 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidi Supported 



Boolean 

bitmap 

■ 


IBitmapHandle 

bitmapSize 



ISize 

bitmapVisible 



Boolean 

borderColor 

■ 

■ 

IColor 

characters ize 



ISize 

clipboardHasTextFormat 



Boolean 

defaultPushButton 



I Windo wHandle 

defaultT ransparentColor 

■ 


IColor 

defaultT ransparentColorSet 



Boolean 

disabledBackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

displaySize 



ISize 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



I Windo wHandle 

hasT ransparentColor 



Boolean 

highlighted 



Boolean 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

isDigits 


■ 
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Figure 139 (Page 2 of 2). Attributes 

IToolBarButton. (S is Set, E is Event) 

Attribute 

S E 

Data type 

itemProvider 

■ 

IDMItemProvider* 

latched 

■ ■ 

Boolean 

latchedB ackgroundColor 

■ 

IColor 

latchedBackgroundColorHalftone 


Boolean 

latchedBitmap 

■ 

IBitmapHandle 

latchedForegroundColor 

■ 

IColor 

latchingEnabled 

■ 

Boolean 

lay out Adjustment 

menu 


IRectangle 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

owner 

■ 

IWindow* 

parent 

■ 

IWindow* 

parentSize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

standardBitmapSize 

■ 

ISize 

standardF ormat 


Boolean 

standar dT extLines 

■ 

unsigned long 

standardTextW idth 

■ 

unsigned long 

tabStop 

■ 

Boolean 

text 

■ ■ 

IString 

textLength 

■ 

unsigned long 

text Visible 


Boolean 

transparentColor 

■ 

IColor 

userData 

■ 

unsigned long 

valid 


Boolean 

valueAsDouble 

■ ■ 


valueAsInt 

■ ■ 


valueAsUnsigned 

■ ■ 


view 

■ 

View 

visible 

■ ■ 

Boolean 

visibleRectangle 


IRectangle 
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Actions - IToolBarButton 

Figure 140 (Page 1 of 2). Actions - IToolBarButton 

Action Parameters 

applyBidiSettings BidiSettings& settings 

Boolean childlnherit= true 
Boolean refresh= true 

capturePointer Boolean capture= true 

clearDefaultT ransparentColor 

click 

convertToGUIStyle IBitFlag& style 

Boolean extendedOnly= false 

disable 

disableAutoLatch 

disableDragDelete 

disableGroup 

disableLatching 

disableMouseClickFocus 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers IEvent& event 

Boolean callDefProc= true 
Boolean enabled= true 
Boolean enable= true 
Boolean enableWindow= true 
IException& dispatcherException 
IEvent& exceptionEvent 

Boolean highlight= true 
unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 

resetBorderColor 
resetDisabledBackgroundColor 
resetDisabledForegroundColor 
resetFont 

resetForegroundColor 
resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 


enable 

enableDragDelete 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

highlight 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 
releasePresSpace 
resetActiveColor 
resetB ackgroundColor 
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Figure 140 (Page 2 of 2). Actions - IToolBarButton 

Action Parameters 

resetLatchedBackgroundColor 
resetLatchedForegroundColor 
resetMinimumSize 
resetShadowColor 

resetT ransparentColor 

sendEvent 


setFocus 

setLayoutDistorted 
show 

showSourceEmphasis 
unhighlight 
unlatch 

Events - IToolBarButton 

Figure 141. Events - IToolBarButton 

Event Notification ID 

buttonClickEvent 
commandEvent 
gotFocusEvent 
inputDisabledEvent 
inputEnabledEvent 
lostFocusEvent 
systemCommandEvent 
visibilityDisabledEvent 
visibilityEnabledEvent 

General Settings - IToolBarButton 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 
Text 

Sets the text for the part. 

Default value: The name of the part 

Latched 

Sets the part to the latched state. 

Default value: Not selected 


buttonClickld 

commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 


unsigned long eventld 
IEventParameterl& parm 1-0 
IEventParameter2& parm2= 0 

unsigned long layoutAttributesOn 
unsigned long layoutAttributesOjf 
Boolean visible=true 
Boolean show= true 
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DLL name 

Specifies the name of the resource .dll that contains the bitmap. 

Default value: None 
Resource ID 

Specifies the resource identifier of the bitmap. 

Default value: None 
Type list 

Lists the available predefined actions that you can associate with the button when it 
is in the latched state. 

Default value: No choice is selected. 

Select from type list 

Enables the Type list so you can select and associate an available predefined action 
with the button when it is in the latched state. 

Default value: No choice is selected. 


Control Settings - IToolBarButton 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 
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Styles Settings - IToolBarButton 

defaultStyle() 

Resets the part to the original default style. 

Default value: Selected 
latchable 

Sets the default style to the latchable state. 

Default value: The Default radio button is selected. 

autoLatch 

Sets the default style for the part the automatic latch state. 

Default value: The Default radio button is selected. 

noPointerFocus 

Allows the cursor stay on a control for which information is required, rather than 
moving to the button. Buttons with this style do not set the focus to themselves 
when the user clicks on them using the mouse. This has no effect on keyboard 
interaction. 

Default value: The Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
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Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IToolBarButton 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 
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Default value: Not highlighted 
Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IToolBarButton 

Color area 

Sets the color of the given area. Choices are as follows: 

Foreground 

Sets the color for foreground text 

Background 

Sets the color for background text 

Latched foreground 

Sets the foreground color for latched text 

Latched background 

Sets the background color for latched text 

Default value: Foreground is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: RGB selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the window area. 

Default value: Not set 
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Size/Position Settings - IToolBarButton 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IToolBarButton 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 51. IVBContainerControl 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IVBContainerControl 
IVBContainerControl 
IContainerControl 
Visual part 
vbbase.vbb 


Objects 



Object 1 


Object 2 


An IVBContainerControl part is a window that can contain nonwindow user interface 
objects. File objects and program objects are common examples of objects managed 
in containers. 

The user can open a container in one of the following views to work with the objects 
in the container: 

View Description 

Text and flowed text 

Lists text representations of objects in a single column. The text 
view lists objects in a single column. The flowed text view lists 
them in multiple columns. 

Name and flowed name 

Lists text representations of objects, with a small icon of the 
object preceding the text. The name view lists objects in a 
single column. The flowed name view lists them in multiple 
columns. 

Icon Represents objects as icons, which can be freely positioned or 

arranged in rows within the container. 

Tree (text, name, and icon) 

Represents objects hierarchically. Objects capable of containing 
nested objects branch from the root of the container. The text. 
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name, and icon tree views represent objects as their 
corresponding nontree views do. 

The user can expand tree branches to view nested objects. 

The tree views are often used for folder hierarchies. 

Details Provides detailed information about each object in the container. 

The information is presented as a table, with a row for each 
object and a column for each represented object attribute. 

Use an IVBContainerControl part to let the user work with a set of objects collected 
in the container. Containers are useful for presenting collections of nonvisual model 
objects. 


Building Guidelines - IVBContainerControl 

When building with an IVBContainerControl part, you can do the following: 

• Define a title for the container. Do this by setting the Title attributes fields on 
the IVBContainerControl General settings page. Enter the title you want in the 
Title field and check the Show title setting. If you want a separator below the 
title, check the Show title separator setting. Select the alignment you want in 
the Alignment field. 

• Specify objects that the container can hold. Do this by setting the Container 
item attributes fields on the IVBContainerControl General settings page:. 

- Designate the object type in the Item type field. 

- Select text representation of objects from choices in the Text field. If you 
use the asString choice for the Text field, consider whether you want the 
default asString result for the object type or need to provide an asString 
override function to produce more meaningful text. 

- Specify object icons in the Icon field. 

• Set the initial view for the container. Do this by selecting a view from the View 
type field on the IVBContainerControl General settings page. 

• Automatically position object icons when objects are added to the container. Do 
this by setting the autoPosition field on the IVBContainerControl Styles settings 
page: 

• Define the types of selection to be supported for the container. Do this by 
setting one or more selection fields to On on the IVBContainerControl Styles 
settings page: 

- extendedSelection 

- multipleSelection 
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Attributes 


- singleSelection 

• Add a pop-up menu for the container and objects it contains. Do this by 
selecting an IMenu part from the parts palette and dropping it on the free-form 
surface. Then, connect the IMenu this attribute to the IVBContainerControl menu 
attribute. 

• Load the container with a set of objects. Do this by connecting the this attribute 
of a collection part containing the choices to the IVBContainerControl items 
attribute. A collection part that has one template argument, such as an 
IVSequence part, must be used. 

• Perform an action when the user double-clicks a container object. Do this by 
connecting the IVBContainerControl selectDefaultActionEvent feature to the 
target action. 


IVBContainerControl 


Figure 142 (Page 1 of 3). Attributes - IVBContainerControl. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

activeColor 

■ 

■ 

IColor 

areDetails V iewT itlesVisible 

■ 


Boolean 

asDebuglnfo 



IString 

asString 



IString 

autoDeleteObject 

■ 


Boolean 

autoDestroyWindow 

■ 


Boolean 

backgroundColor 

■ 

■ 

IColor 

bidiSupported 



Boolean 

borderColor 

■ 

■ 

IColor 

cachingEnabled 

■ 


Boolean 

characters ize 



ISize 

columnCount 



unsigned long 

currentEditColumn 



IContainerColumn * 

currentEditMLE 



IMultiLineEdit* 

currentEditObj ect 



IContainerObject* 

cursoredObject 



IContainerObject* 

defaultPushButton 



IWindowHandle 

detail sTitleRectangle 



IRectangle 

details View 



Boolean 

detail s V ie wPortOnWindow 



IRectangle 

detail s V ie wPortOn W orkspace 



IRectangle 

detailsViewSplit 

■ 


IContainerColumn * 

disabledB ackgroundColor 

■ 

■ 

IColor 

disabledForegroundColor 

■ 

■ 

IColor 

drawBackgroundEnabled 

■ 


Boolean 

drawItemEnabled 

■ 


Boolean 

enabled 

■ 

■ 

Boolean 

enabledForNotification 

■ 


Boolean 

extendedSelection 



Boolean 

flowed 



Boolean 

flo wedN ame V ie w 



Boolean 


Chapter 51. IVBContainerControl 453 





Figure 142 (Page 2 of 3). Attributes 

IVBContainerControl. 

(S is Set, E is Event) 

Attribute 

s 

E 

Data type 

flo wedT ext V iew 



Boolean 

focus 


■ 

Boolean 

font 

■ 

■ 

IFont 

foregroundColor 

■ 

■ 

IColor 

frame Window 



Boolean 

group 

■ 


Boolean 

handle 



I Windo wHandle 

hiliteB ackgroundColor 

■ 

■ 

IColor 

hiliteForegroundColor 

■ 

■ 

IColor 

iconSize 

■ 


ISize 

icon View 



Boolean 

id 

■ 


unsigned long 

inactiveColor 

■ 

■ 

IColor 

itemProvider 

■ 


IDMItemProvider* 

items 

■ 

■ 

IVSequence < Element >* 

lay out Adjustment 



IRectangle 

lineSpacing 

■ 


long 

menu 




messageQueue 



IMessageQueueHandle 

minimumSize 

■ 


ISize 

mixedT argetEmphasi s 



Boolean 

multipleSelection 



Boolean 

name View 



Boolean 

nativeRect 



IRectangle 

normalT argetEmphasi s 



Boolean 

numberOfColumnChanges 



unsigned long 

numberOfObj ectChanges 



unsigned long 

numberOfSelections 



unsigned long 

objectCount 



unsigned long 

objectList 



ICnrObjectSet 

orderedT argetEmphasis 



Boolean 

owner 

■ 


IWindow* 

parent 

■ 


IWindow* 

parents ize 



ISize 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

refreshOn 

■ 


Boolean 

selected Cnr Obj ects 



IVSequence < CnrElement * >* 

selectedObjects 



IVSequence < Element >* 

selectionlndices 

■ 


IVSequence < unsigned long >* 

selectionls Valid 



Boolean 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

showingMinilcons 



Boolean 

singleSelection 



Boolean 

size 

■ 

■ 

ISize 

splitBarOffset 



unsigned long 

tabStop 

■ 


Boolean 

text View 



Boolean 
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Figure 142 (Page 3 of 3). Attributes - IVBContainerControl. (S is Set, E is Event) 


Attribute 

s 

E 

Data type 

title 

■ 

■ 

IString 

titleRectangle 



IRectangle 

titleSeparatorVisible 

■ 


Boolean 

titleVisible 

■ 

■ 

Boolean 

titleWriteable 

■ 


Boolean 

treelconView 



Boolean 

treeNameView 



Boolean 

treeTextView 



Boolean 

tree View 



Boolean 

valid 



Boolean 

vie wPortOn W indo w 



IRectangle 

vie wPortOn W orkspace 



IRectangle 

visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 

willDeleteColumnsOnClose 



Boolean 

willDeleteObjectsOnClose 



Boolean 


Actions - IVBContainerControl 

Figure 143 (Page 1 of 5). Actions - IVBContainerControl 


Action Parameters 


addColumn 

IContainerColumn* column 

addltem 

IContainerColumn* afterColumn= 0 
unsigned long position 

addObject 

IContainerObject* new Object 

addObject After 

IContainerObject* parentObject= 0 
IContainerObject* new Object 

addObjects 

IContainerObject* afterObject 
IContainerObject* parentObject= 0 
ICnrAllocator& allocator 

addObj ects After 

IContainerObject* parentObject= 0 
ICnrAllocator& allocator 

applyBidiSettings 

IContainerObject* pcnrobjAfter 
IContainerObject* parentObject= 0 
BidiSettings& settings 

arrangelcon V ie w 
capturePointer 

Boolean childlnherit= true 

Boolean refresh=tme 

Boolean capture=tme 

closeEdit 

collapse 

IContainerObject* object 

collapseTree 

columnAt 

unsigned long index 

columnUnderPoint 

IPoint& point 

containerFromHandle 

IWindowHandle& handle 

containsObject 

IContainerObject* object 

con vertT oGUIS ty le 

IBitFlag& style 

convertToWorkspace 

Boolean extendedOnly= false 
IRectangle& windowRectangle 
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Figure 143 (Page 2 of 5). Actions - 

■ IVBContainerControl 

Action 

Parameters 

copyObjectTo 

Boolean rightWindow= false 

IContainerObject* copyObject 

deleteAllObjects 

deleteltem 

IContainerObject* parentObject=0 

IContainerControl* new Container^ 

IContainerObject* afterObject= 0 

IPoint& iconViewLocation= IPoint (0,0) 

unsigned long position 

deleteSelectedObjects 

descendentsOf 

IContainerObject* parentObject 

deselectAll 

detailsObjectRectangle 

IContainerObject* object 

disable 

disableCaching 

disableDataUpdate 

Boolean rightWindow= false 

IContainerObject* object 

disableDrawBackground 

disableDrawItem 

disableDrop 

IContainerObject* object 

disableGroup 

disableNotification 

disableTabStop 

disableTitleUpdate 

disableUpdate 

dispatchRemainingHandlers 

IEvent& event 

editColumnTitle 

Boolean callDefProc-XxxxQ 

IContainerColumn* column 

editContainerT itle 
editObject 

IContainerObject* object 

enable 

IContainerColumn* column= 0 

Boolean enabled= true 

enableDataUpdate 

IContainerObject* object 

enableDrop 

Boolean enable= true 

IContainerObject* object 

enableUpdate 

Boolean enable= true 

Boolean enableWindow=ime 

expand 

IContainerObject* object 

expandTree 

filter 

handleException 

IException& dispatcherException 

hide 

hideDetailsViewTitles 

hideObject 

IEvent& exceptionEvent 

IContainerObject* object 

hideSourceEmphasis 

hideSplitBar 

hideTitle 

hideTitleSeparator 

hideTreeLine 

iconRectangle 

IContainerObject* object 


Boolean includeText=fa\se 
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Figure 143 (Page 3 of 5). Actions - IVBContainerControl 

Action Parameters 


immediateDescendentsOf 

initialize 

isCollapsed 

isColumnRight 

isCursored 

isDropOnAble 

isExpanded 

isInUse 

isLayoutDistorted 

isMoveValid 


isSelected 

isSource 

isTarget 

isWriteable 

matchForMnemonic 

movelconTo 

moveObjectTo 


nlsCompare 

notifyObservers 
object At 

objectUnderPoint 

operator == 

parentObject 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 


refresh 

refreshAllContainers 

refreshF romList 

releasePointer 

releasePresSpace 

removeAllObjects 

removeColumn 

removelnUse 

removeObject 

removeSelected 

removeSelectedObjects 

resetActiveColor 


IContainerObject* parentObject 

IContainerObject* object 
IContainerColumn* column 
IContainerObject* object 
IContainerObject* object 
IContainerObject* object 
IContainerObject* object 
unsigned long lay out Attribute 
IContainerObject* moveObject 
IContainerObject* newParentObject= 0 
IContainerControl* newContainer= 0 
IContainerObject* afterObject= 0 
IContainerObject* object 
IContainerObject* object 
IContainerObject* object 
IContainerObject* object 
unsigned short character 
IContainerObject* object 
IPoint& point 

IContainerObject* moveObject 
IContainerObject* newParentObject= 0 
IContainerControl* newContainer= 0 
IContainerObject* afterObject=0 
IPoint& iconViewLocation= IPoint (0,0) 
char* textl 
char* text2 

INotificationEvent& event 
unsigned long index 
IPoint& point 

IContainerControl& container 
IContainerObject* childObject 
IWindowHandle& siblingWindow 


unsigned long eventld 
IEventParameter 1 & parml =0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 


IPresSpaceHandle& presentationSpaceHandle 

IContainerColumn* column 
IContainerObject* object 
IContainerObject* object 
Boolean allContainers= false 
IContainerObject* object 
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Figure 143 (Page 4 of 5). Actions - IVBContainerControl 

Action Parameters 


resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteB ackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

scroll 


scrollDetailsHorizontally 

scrollHorizontally 

scrollToObject 
scroll Vertically 
selectAll 
sendEvent 


setCursor 

setDeleteColumnsOnClose 

setDeleteObjectsOnClose 

setEditColumn 

setEditMLE 

setEditObject 

setExtendedSelection 

setFocus 

setlnUse 

setLayoutDistorted 

setMixedT argetEmphasis 
setMultipleSelection 
setN ormalT argetEmphasis 
setOrderedT argetEmphasi s 
setRefreshOff 
setSelected 

setSingleSelection 
setTitleAlignment 
setT reeExpandlconS ize 
setT reeltemlcons 

setT ree V ie wlndent 
show 

showDetailsView 


long vericalPixels 
long horizontalPixels 
Boolean rightSide- false 
long horizontalPixels 
Boolean rightSide= false 
long pixels 

Boolean rightSide- false 
IContainerObject* object 
long pixels 

unsigned long eventld 
IEventParameter 1 & parml= 0 
IEventParameter2& parm2= 0 
IContainerObject* object 
Boolean destroy=truQ 
Boolean destroy=tm& 
IContainerColumn* column 
IMultiLineEdit* editField 
IContainerObject* object 


IContainerObject* object 
Boolean inUse- true 
unsigned long lay out Attribute sOn 
unsigned long lay outAttribute sOff 


IContainerObject* object 
Boolean select= true 

Title Alignment alignment- IContainerControl:: centered 

ISize& sizelcon 

IResourceId& expanded 

IResourceId& collapsed 

long indentPixels=- 1 

Boolean visible=tme 
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Figure 143 (Page 5 of 5). Actions ■ 

■ IVBContainerControl 

Action 

Parameters 

sho wFlo wedN ame V ie w 


showFlowedTextView 


sho wlcon View 


showMinilcons 

Boolean mzm=true 

sho wN ame V ie w 


showObject 

IContainerObject* object 


Boolean visible=tme 

showSourceEmphasis 

Boolean show= true 

showSplitBar 

Boolean showSplitBar= true 

sho wText View 


showTreelconView 


showTreeLine 

long tree Line PixelWidth=-\ 

sho wTreeN ame V ie w 


sho wT reeT ext V ie w 


sortBylconText 

Boolean ascending=truQ 

textRectangle 

IContainerObject* object 


Events - IVBContainerControl 

Figure 144. Events - IVBContainerControl 

Event 

Notification ID 

addEvent 

addld 

commandEvent 

commandld 

detail s V ie wT itlesEvent 

detailsViewTitlesId 

enterEvent 

enterld 

gotFocusEvent 

FOCU STRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

F.NABT ETRTIBTD 

lostFocusEvent 

FOCUSFALSEID 

removeEvent 

removeld 

selectEvent 

selectld 

selectionDefaultActionEvent 

selectionDefaultActionld 

selectionlndexChangedEvent 

selectionlndexChangedld 

systemCommandEvent 

sy stemC ommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VTSTBI F.TRt IF.TD 


General Settings - IVBContainerControl 


Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Title 

Sets the title to appear on the title bar for the part. 

Default value: None 
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Title attributes 

Sets the title for the container. 

Default value: None 

Container item attributes 

Specifies the objects that the container can hold. 

Default value: None 
Show title 

Shows the container’s title. 

Default value: Not selected 
Show title separator 

Displays a horizontal separator between the title and the work area of a container 
part. 

Default value: Not selected 
Title alignment 

Sets the alignment attributes for the title. 

Default value: Not selected 
View type 

Sets the view type for the part, which can be one of the following: 

Details view 

Shows the details view of the container. 

Flowed name view 

Sets the current view to the flowed name view. 

Flowed text view 

Sets the current view to the flowed name view. 

Icon view 

Shows the icon view of the container. 

Name view 

Shows the name view of the container. 

Text view 

Sets the current view to the nonflowed text view. 

Tree icon view 

Shows the tree icon view of the container. 

Tree name view 

Shows the tree name view of the container. 
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Tree text view 

Shows the text name view of the container. 

Default value: Not selected 
Item type 

Specifies the part type of objects in the collection. 

Default value: None 
Text 

Sets the text for the part. 

Default value: The name of the part 

Icon 

Sets the icon handle of the part. 

Default value: None 
Collection type 

Specifies the part type of the collection. 

Default value: IVSequence* 

Line spacing 

Sets the space between lines, in pixels. 

Default value: 2 

Refresh the container after changes 

Refreshes all parts in the container after updates are made. 

Default value: Selected 
EnableDrawBackground 

Enables the background of the container to be redrawn. 

Default value: Not selected 
EnableDrawItem 

Enables list box items to be drawn, which are typically used to display bitmaps. 
Default value: Not selected 
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Control Settings - IVBContainerControl 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IVBContainerControl 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
autoPosition 

Automatically positions parts that are added to the container in the icon view. 
Default value: The Default radio button is selected. 

verifyPointers 

Validates that container parts exist. 

Default value: The Default radio button is selected. 

noSharedObjects 

Disallows sharing objects with other containers. 

Default value: The default is off, and the Default radio button is selected. 

extendedSelection 

Specifies that the container use extended selection. 

Default value: The default is off, and the Default radio button is selected. 
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singleSelection 

Specifies that the container use single selection. 

Default value: The default is on, and the Default radio button is selected. 

group 

Identifies the control as being the first in a group. No other controls in the group 
can have this style. Controls in the group must be siblings that are constructed 
following the first control. The group can be cursored and when the last control in 
the group is reached, the cursor returns the first control in the group. 

Default value: The default is off, and the Default radio button is selected. 

tabStop 

Identifies the control as one to which the user can tab. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 
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Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IVBContainerControl 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 
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Size/Position Settings - IVBContainerControl 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IVBContainerControl 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 52. IVBFactory 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IVBFactory 

IVBFactory 

None 

Nonvisual part 
vbbase.vbb 


FrameWindow2 


An IVBFactory dynamically creates new parts of a type you specify. 

The user interacts with parts created by the object factory but does not have access to 
the factory itself. 

Use an IVBFactory part to generate dynamic parts. 


Building Guidelines - IVBFactory 

When building with an IVBFactory part, you can do the following: 

• Define an object factory for a part type. Do this by adding an object factory to 
your composite part and specifying the part type the factory creates. For 
example, define a frame window factory as follows: 

1. Drop an IVBFactory part on the free-form surface. 

2. Open the contextual menu of the factory, select the Change Type choice, 
and enter the data type you need. 

• Create an object when an event occurs. Do this by connecting the event to the 
IVBFactory new action. 
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Actions - IVBFactory 

Figure 145. Actions - IVBFactory 

Action 

new 

Events - IVBFactory 

Figure 146. Events - IVBFactory 

Event 

newEvent 
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Parameters 


Notification ID 

newObjectCreateld 



Chapter 53. IVBFileDialog 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM VB file dialog window 
IVBFileDialog 
IStandardNotifier 
Nonvisual part 
vbbase.vbb 



VBFileDialogl 


An IVBFileDialog part is a placeholder for a file dialog. While building your 
application, the placeholder represents a file dialog for connections from other parts. 
When your application is built and run, a file dialog replaces the placeholder. A file 
dialog provides an input field and other controls for file identification. 

With a file dialog, the user can select a file to work with or specify a file name for 
saving current work. 

Use an IVBFileDialog part to represent a file dialog during application building. 


Building Guidelines - IVBFileDialog 

When building with an IVBFileDialog part, you can do the following: 

• Define a title for the dialog. Do this by entering the title in the Title field on the 
IVBFileDialog General settings page. 

• Provide an initial file name for the dialog. Do this by entering the name in the 
File name field on the IVBFileDialog General settings page. 

• Show only files of a particular extended attribute type in the file list. Do this by 
specifying the type in the File type (EA type) field on the IVBFileDialog 
General settings page. Leave this field empty to show all available files in the 
list. 

• Define text for the OK push button. For example, you might want the button 
text to be Open or Save as. Do this by entering the text in the OK button text 
field on the IVBFileDialog General settings page. 
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• Identify the frame window that the file dialog is related to. If you have only one 
frame window in your view, the dialog is automatically related to that frame 
window. 

If you want the file dialog for a second frame window in your view, do this by 
referencing the frame window Subpart name, which appears on its General 
settings page. Enter the frame window subpart name, prefixed with “i,” in the 
Owner field on the IVBFileDialog General settings page. 

• Show the dialog when the user selects a menu choice. Do this by connecting the 
IMenuItem commandEvent feature to the IVBFileDialog showModally action. 

• Perform the requested file operation for a part that works with files. For 
example, to load an IMultiFineEdit part from a file, do this as follows: 

1. Connect the IVBFileDialog pressedOK event to the IMultiFineEdit 
importFromFile action. 

2. Connect the IVBFileDialog fileName attribute to the fileName parameter of 
the pressedOK-to-importFromFile connection. 

• Perform the requested file operation for a part that does not work with files. Do 
this with a member function as follows: 

1. Connect the IVBFileDialog pressedOkEvent feature to the free-form surface. 

2. Select the More choice on the connection menu. 

3. Enter the signature of a member function to perform the operation. 

4. Connect the IVBFileDialog fileName attribute to a file name parameter on 
the connection to the member function. 

• Alternatively, perform the file operation with custom logic as follows: 

1. Connect the IVBFileDialog pressedOkEvent feature to the free-form surface. 

2. Select the Custom logic choice on the connection menu. 

3. Enter the C++ code to perform the operation. Access the file name in your 
custom logic by pressing the Source push button. Enter the get member 
function of the fileName attribute after the source pointer inserted into your 
code. This is the resulting code segment: 

source->fi1eName() 
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Attributes - IVBFileDialog 

Figure 147. Attributes - IVBFileDialog. 

Attribute 

asDebuglnfo 

asString 

buttonPressedld 

enabledForNotification 

fileDialog 

tileDialogSettings 

fileName 

modeless 

pressedOK 

returnValue 

saveAsEAType 

selectedFileCount 


Actions - IVBFileDialog 

Figure 148. Actions - IVBFileDialog 

Action 

addDrive 

addFileType 

disableNotification 

notifyObservers 

operator = 

setDialogT emplate 

setlnitialDrive 

setlnitialFileType 

setOKButtonText 

setOpenDialog 

setPosition 

setSaveAsDialog 

setTitle 

show 


showModally 


(S is Set, E is Event) 

S E Data type 

IString 

IString 

long 

■ Boolean 
IFileDialog* 
IFileDialog: Settings* 

■ ■ IString 

Boolean 

Boolean 

long 

IString 

unsigned long 


Parameters 

char* drive 
char* fileType 

INotificationId& nld 
IStandardNotifier& aStandardNotifier 
IResourceId& resourceld 
char* drive 
char* fileType 
IResourceId& resld 

IPoint& position 

char* newTitle 
IWindow* parent 

IFileDialog::Style .sfy/e=IFileDialog::defaultStyle ( ) 
IHandler* handler= 0 
IWindow* parent=NULL 

IFileDialog::Style sfy/e=IFileDialog::defaultStyle ( ) 
IHandler* handler= 0 


Chapter 53. IVBFileDialog 471 



Events - IVBFileDialog 

Figure 149. Events - IVBFileDialog 

Event Notification ID 


createdEvent 

dismissedEvent 

pressedOkEvent 


createdld 

dismissedld 

pressedOkld 


General Settings - IVBFileDialog 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Owner 

Sets the window’s owner. 

Default value: None 
Title 

Sets the title to appear on the title bar for the part. 

Default value: None 

File type (EA type) 

Sets the file type selected by the user. 

Default value: None 
File name 

Sets the fully qualified file name selected by the user. 

Default value: None 
OK button text 

Sets the text that appears on the OK button. 

Default value: None 
Search 

Lets the user search for the file name. 

Default value: The default is off, and the Default radio button is selected. 
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Chapter 54. IVBFIyText 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM VB fly-over text control 

IVBFIyText 

IFlyText 

Nonvisual part 

vbbase.vbb 


VBFIyTentl 


An IVBFIyText part displays fly-over text for other parts. Fly-over text is a brief 
description of a control that appears when the user places the mouse pointer on the 
control. The text generally appears in a small rectangle near the control. 

The user can read help information in the fly-over text without opening another 
window for help. 

Use an IVBFIyText part to briefly describe controls in your frame window. 


Building Guidelines - IVBFIyText 

When building with an IVBFIyText part, you can do the following: 

• Associate fly-over text with a frame window. Do this as follows: 

1. Drop an IVBFIyText part on the free-form surface in your frame window 
view. 

2. For your frame window and each control, enter brief fly-over text in the Fly 
over short text field on its Control settings page. 

• Display lengthier fly-over text in an information area. Do this as follows: 

1. Connect the IlnfoArea this attribute to the FlyOverHelpHandler 
longTextControl attribute. 

2. For your frame window and each control, enter the fly-over text in the Fly 
over long text field on its Control settings page. 
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• Identify the frame window that the fly-over text is related to. If you have only 
one frame window in your view, the fly-over text is automatically related to that 
frame window. 

If you want fly-over text for a second frame window in your view, do this by 
referencing the frame window Subpart name, which appears on its General 
settings page. Enter the frame window subpart name, prefixed with “i,” in the 
Owner field on the General settings page of a second IVBFlyText part. 


Attributes - IVBFlyText 

Figure 150 (Page 1 of 2). Attributes - IVBFlyText. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

characters ize 


ISize 

clipboardHasTextFormat 


Boolean 

defaultPushButton 


I Windo wHandle 

di sabledB ackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

displaySize 


ISize 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

flyOverHelpHandler 


IFlyOverHelpHandler* 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


I Windo wHandle 

hiliteB ackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

isDigits 

■ 


itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 


IRectangle 

longT extControl 

■ 

ITextControl* 

menu 



messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

owner 

■ 

I Window* 

parent 

■ 

I Window* 

parents ize 


ISize 
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Figure 150 (Page 2 of 2). Attributes ■ 

■ IVBFIyText. 

(S is Set, E is Event) 

Attribute 

S 

E 

Data type 

pointerCaptured 



Boolean 

position 

■ 

■ 

IPoint 

presSpace 



IPresSpaceHandle 

rect 

■ 


IRectangle 

relativeWindowRect 

■ 


IRectangle 

shadowColor 

■ 

■ 

IColor 

showing 



Boolean 

size 

■ 

■ 

ISize 

tabStop 

■ 


Boolean 

text 

■ 

■ 

IString 

textLength 


■ 

unsigned long 

valid 



Boolean 

valueAsDouble 

■ 

■ 


valueAsInt 

■ 

■ 


valueAsUnsigned 

■ 

■ 


visible 

■ 

■ 

Boolean 

visibleRectangle 



IRectangle 


Actions - IVBFIyText 

Figure 151 (Page 1 of 2). Actions - IVBFIyText 


Action Parameters 


applyBidiSettings 

BidiSettings& settings 

Boolean childlnherit=\mt 

Boolean refresh-tme. 

capturePointer 

Boolean capture=tm& 

con vertT oGUIS ty le 

IBitFlag& style 

Boolean extendedOnly= false 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

IEvent& event 

Boolean callDefProc= true 

enable 

Boolean enabled= true 

enableUpdate 

Boolean enableWindow=tmQ 

handleException 

IException& dispatcherException 
IEvent& exceptionEvent 

hide 

hideSourceEmphasis 

isLayoutDistorted 

unsigned long lay out Attribute 

matchForMnemonic 

unsigned short character 

notifyObservers 

INotificationEvent& event 

positionBehindSibling 

positionBehindSiblings 

IWindowHandle& siblingWindow 

positionOnSiblings 

postEvent 

unsigned long eventld 
IEventParameter 1 & parml =0 
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Figure 151 (Page 2 of 2). Actions - IVBFlyText 

Action Parameters 


refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 

resetHiliteBackgroundColor 

resetHiliteForegroundColor 

resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

sendEvent 


setFocus 

setLayoutDistorted 

show 

showSourceEmphasis 


IEventParameter2& parm2=0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


unsigned long eventld 
IEventParameter 1 & parml=0 
IEventParameter2& parm2=0 

unsigned long lay out Attribute sOn 
unsigned long lay outAttribute sOff 
Boolean visible=tme 
Boolean show= true 


Events - IVBFIyText 

Figure 152. Events - IVBFIyText 


Event 


Notification ID 


commandEvent 

gotFocusEvent 

inputDisabledEvent 

inputEnabledEvent 

lostFocusEvent 

systemCommandEvent 

visibilityDisabledEvent 

visibilityEnabledEvent 


commandld 

FOCUSTRUEID 

ENABLEFALSEID 

ENABLETRUEID 

FOCUSFALSEID 

systemCommandld 

VISIBLEFALSEID 

VISIBLETRUEID 
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General Settings - IVBFIyText 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Owner 

Sets the window’s owner. 

Default value: None 


Handlers Settings - IVBFIyText 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 

Default value: None 
Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 
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Font Settings - IVBFIyText 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 55. IVBFontDialog 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM VB font dialog window 
IVBFontDialog 
IStandardNotifier 
Nonvisual part 
vbbase.vbb 



VBFontDialogl 


An IVBFontDialog part is a placeholder for a font dialog. While building your 
application, the placeholder represents a font dialog for connections from other parts. 
When your application is built and run, a font dialog replaces the placeholder. A font 
dialog provides selection fields and other controls for font specification. 

With a font dialog, the user can select a font name, size, and styles to use with your 
application. 

Use an IVBFontDialog part to represent a font dialog during application building. 


Building Guidelines - IVBFontDialog 

When building with an IVBFontDialog part, you can do the following: 

• Define a title for the dialog. Do this by entering the title in the Title field on the 
IVBFontDialog General settings page. 

• Show only fonts in one font family, such as Helvetica or Courier, in the font list. 
Do this by specifying the font family in the Font family name field on the 
IVBFontDialog General settings page. Leave this field empty to show all 
available fonts in the list. 

• Provide preview text to show font appearance in the dialog. Do this by entering 
the text in the Preview text field on the IVBFontDialog General settings page. 

• Identify the frame window that the font dialog is related to. If you have only one 
frame window in your view, the dialog is automatically related to that frame 
window. 
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If you want the font dialog for a second frame window in your view, do this by 
referencing the frame window Subpart name, which appears on its General 
settings page. Enter the frame window subpart name, prefixed with “i,” in the 
Owner field on the IVBFontDialog General settings page. 

• Show the dialog when the user selects a menu choice. Do this by connecting the 
IMenuItem commandEvent feature to the IVBFontDialog showModally action. 

• Apply the requested font selection. Do this with a member function as follows: 

1. Connect the IVBFontDialog pressedOkEvent feature to the free-form surface 

2. Select the More choice on the connection menu. 

3. Enter the signature of a member function to perform the operation. 

4. Connect the IVBFontDialog font attribute to a font parameter on the 
connection to the member function. 

• Alternatively, perform the font operation with custom logic as follows: 

1. Connect the IVBFontDialog pressedOkEvent feature to the free-form surface 

2. Select the Custom logic choice on the connection menu. 

3. Enter the C++ code to perform the operation. Access the font selection in 
your custom logic by pressing the Source push button. Enter the get 
member function of the fan 1 attribute after the source pointer inserted into 
your code. This is the resulting code segment: 

source->font() 


Attributes - IVBFontDialog 


Figure 153 (Page 1 of 2). Attributes - IVBFontDialog. 

(S is Set, E is Event) 

Attribute S 

E 

Data type 

asDebuglnfo 


IString 

asString 


IString 

buttonPressedld 


unsigned long 

emHeight 


unsigned long 

enabledForNotification ■ 


Boolean 

externalLeading 


unsigned long 

font ■ 

■ 

IFont 

fontDialog 


IFontDialog* 

fontDialogSettings 


IFontDialog:: Settings* 

fontFamily 


IString 

fontWeight 


unsigned long 

fontWidth 


unsigned long 

modeless 


Boolean 

nominalPointSize 


unsigned long 

pointSize ■ 


unsigned long 

pressedOK 


Boolean 

return Value 


long 
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Figure 153 (Page 2 of 2). Attributes - IVBFontDialog. (S is Set, E is Event) 


Attribute 

S 

E 

Data type 

xHeight 



unsigned long 


Actions - IVBFontDialog 


Figure 154. Actions - IVBFontDialog 


Action 

Parameters 

disableNotification 

notifyObservers 

INotificationId& nld 

operator = 

IStandardNotifier& aStandardNotifier 

setDialogT emplate 

IResourceId& templateld 

setDisplayPS 

IPresSpaceHandle& presSpaceHandle 

setFamily 

char* fontFamily 

setF ontFromF ontModally 

IFont* target 

IWindow* parent=N\JLL 

IFontDialog::Style s/y/£=IFontDialog::defaultStyle ( ) 
IHandler* handler= 0 

setFontFromWindowModally 

IWindow* target 

IWindow* parent= NULL 

IFontDialog::Style s/y/£=IFontDialog::defaultStyle ( ) 
IHandler* handler= 0 

setPosition 

IPoint& position 

setPreviewText 

char* previewText 

setPrinterPS 

IPresSpaceHandle& presSpaceHandle 

setSizeList 

char* sizeList 

setTitle 

char* title 

show 

IWindow* parent 

IFontDialog::Style s/y/£=IFontDialog::defaultStyle ( ) 
IHandler* handler= 0 

showFromFont 

IFont* target 

IWindow* parent 

IFontDialog::Style s/y/£=IFontDialog::defaultStyle ( ) 
IHandler* handler= 0 

showModally 

IWindow* parent=N\JLL 

IFontDialog::Style s/y/£=IFontDialog::defaultStyle ( ) 
IHandler* handler= 0 

Events - IVBFontDialog 


Figure 155. Events - IVBFontDialog 

Event 

Notification ID 

createdEvent 

createdld 

dismissedEvent 

dismissedld 

pressedOkEvent 

pressedOkld 
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General Settings - IVBFontDialog 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Owner 

Sets the window’s owner. 

Default value: None 
Title 

Sets the title to appear on the title bar for the part. 

Default value: None 

Font family name 

Sets the family name of the font. 

Default value: None 
Preview text 

Sets the text to display in the font sample box. 

Default value: None 
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Chapter 56. IVBNotebookPage 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IVBNotebookPage 
IVBNotebookPage 
IStandardNotifier 
Nonvisual part 
vbbase.vbb 



An IVBNotebookPage part is a software representation of a physical notebook page. 
It presents information that is generally related and can have a tab for direct user 
access. 

The user can do the following with a notebook page: 

• View or change information by using other controls 

• Turn the page by clicking on page buttons 

Use an IVBNotebookPage part for settings choices or for related information. 


Building Guidelines - IVBNotebookPage 

When building with an IVBNotebookPage part, you can do the following: 

• Add a page to a notebook. Do this by clicking mouse button 2 on the notebook 
and selecting an add page choice. When there are no pages in the notebook, 
your only page choice is Add Initial Page. When the notebook has one or more 
pages, select Add Page After or Add Page Before. An IVBNotebookPage part 
is placed in the notebook. 

• Select a tab type for the page. By default, the page has a major tab. 

If you want a minor tab on the page, set the minorTab field to On and set the 
majorTab field to Off on the IVBNotebookPage Styles settings page. 

If you want no tab on the page, set both fields to Off. Do not set both fields to 

On. 
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• Define text for a tab. Do this by entering the text you want in the Tab text field 
on the IVBNotebookPage General settings page. 

• Define text for the status area at the bottom of the page. Do this by entering the 
text you want in the Status text field on the IVBNotebookPage General settings 
page. 

• Place a part on a notebook page. A notebook page accepts only one part, so you 
should place one of the canvases or a view port on the page. If you use a view 
port, place a canvas in the view port. After you have a canvas on the notebook 
page, you can place controls on the canvas. 

Place the part you want on the notebook page by selecting it from the parts 
palette and dropping it on the page. Expand the canvas or view port by selecting 
it and dragging its corner handle. Leave part of the notebook page exposed so 
you can still access the notebook page. If the autoPageSize field on the Styles 
settings page is set to On, the part placed on the notebook page fills the page in 
generated code. The autoPageSize field is set to On by default. 


Attributes - IVBNotebookPage 


Figure 156. Attributes - IVBNotebookPage. (S is Set, E is Event) 


Attribute 

S E 

Data type 

asDebuglnfo 


IString 

asString 


IString 

enabledForNotification 

■ 

Boolean 

notebook 


const IWindow'" 

pageHandle 


IPageHandle 

statusText 

■ 

IString 

tabBitmap 

■ 

IBitmapHandle 

tabText 

■ 

IString 

window 

■ 

IWindow* 

BNotebookPage 

Figure 157. Actions - IVBNotebookPage 



Action 

Parameters 



disableNotification 
notifyObservers 
operator = 


INotificationId& nld 
IStandardNotifier& aStandardNotifier 
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General Settings - IVBNotebookPage 

Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 

Tab text 

Sets the text for the notebook tab. 

Default value: Tab 
Status text 

Sets the text for the status area of the notebook page. 

Default value: None 


Styles Settings - IVBNotebookPage 

statusTextOn 

Sets the text of the status line associated with this notebook page. 
Default value: The Default radio button is selected. 

minorTab 

Specifies that the tab is associated with a minor tab. 

Default value: The Default radio button is selected. 

majorTab 

Specifies that the tab is associated with a major tab. 

Default value: The default is on. 

noAttribute 

Restricts the tab from being associated with an attribute. 

Default value: The Default radio button is selected. 
autoPageSize 

Automatically sets the size of the notebook page. 

Default value: The default is on. 
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Chapter 57. IVBVariableClass 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM placeholder for class instance 

IVBVariableClass 

IVBVariableClassBase 

Nonvisual part 

vbbase.vbb 


Datel 


An IVBVariableClass part is a placeholder for class data. Visual Builder uses 
IVBVariableClass when you specify a class type, such as IDate, for an IVBVariable. 

The user does not have access to these variables. 

Use an IVBVariable to pass data between composite parts. 


Building Guidelines - IVBVariableClass 

Building guidelines for an IVBVariable are provided in documentation of 
IVBVariablePart. 


Attributes - IVBVariableClass 

Figure 158. Attributes - IVBVariableClass. (S is Set, E is Event) 


Attribute S E Data type 


asDebuglnfo 



IString 

asString 



IString 

autoDeleteT arget 

■ 


Boolean 

enabledForNotification 

■ 


Boolean 

targetPtr 



Element* 

this 

■ 

■ 

Element 
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Actions - IVBVariableClass 

Figure 159. Actions - IVBVariableClass 

Action Parameters 

disableNotification 

notifyObservers INotificationId& nld 

operator = IStandardNotifier& aStandardNotifier 
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Chapter 58. IVBVariableClassPointer 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM placeholder for class instance 

IVBVariableClassPointer 

IVBVariableClassBase 

Nonvisual part 

vbbase.vbb 


Datel 


An IVBVariableClassPointer part is a placeholder for a pointer to class data. Visual 
Builder uses IVBVariableClassPointer when you specify a class pointer type, such as 
IDate*, for an IVBVariable. 

The user does not have access to these variables. 

Use an IVBVariable to pass data between composite parts. 


Building Guidelines - IVBVariableClassPointer 

Building guidelines for an IVBVariable are provided in documentation of 
IVBVariablePart. 


Attributes - IVBVariableClassPointer 

Figure 160. Attributes - IVBVariableClassPointer. (S is Set, E is Event) 


Attribute S E Data type 


asDebuglnfo 



IString 

asString 



IString 

autoDeleteT arget 

■ 


Boolean 

enabledForNotification 

■ 


Boolean 

targetPtr 



Element 

this 

■ 

■ 

Element 
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Actions - IVBVariableClassPointer 

Figure 161. Actions - IVBVariableClassPointer 

Action Parameters 

deleteTarget 

disableNotification 
notifyObservers 
operator = 


INotificationId& nld 
IStandardNotifier& aStandardNotifier 
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Chapter 59. IVBVariablePart 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM placeholder for part instance 

IVBVariablePart 

IVBVariablePartBase 

Nonvisual part 

vbbase.vbb 


[n] 

FrameWindow2 


An IVBVariablePart part is a placeholder for part data. Visual Builder uses 
IVBVariablePart when you specify a part type, such as IEntryField, for an 
IVBVariable. 

The user does not have access to these variables. 

Use an IVBVariable to pass data between composite parts. 


Building Guidelines - IVBVariablePart 

When building with an IVBVariable, you can do the following: 

• Change the variable type to the part or class type you need. Do this as follows: 

1. If any other part is selected, click on the variable with mouse button 1 to 
select the variable. 

2. Click on the variable with mouse button 2 to open the contextual menu of 
the variable. 

3. Select the Change Type choice from the menu. 

4. Enter the data type you need. You can specify one of the following types: 

- Part type, such as IEntryField. This is implemented as an 
IVBVariablePart. 

- Part type pointer, such as IEntryField*. This is implemented as an 
IVB V ariablePartPointer. 

- Class type, such as IDate. This is implemented as an IVBVariableClass. 
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- Class type pointer, such as IDate*. This is implemented as an 
IVB V ariableClassPointer. 

• Change the variable name to something meaningful to your application. Do this 
as follows: 

1. Open the contextual menu of the variable. 

2. Select the Change Name choice from the menu. 

3. Enter the name you want. 

• Add variable features to the interface of the composite part you are building. 
Give the variable a meaningful name before you promote features. This ensures 
that generated feature names are based on the meaningful name. 

Promote features as follows: 

1. Open the contextual menu of the variable. 

2. Select the Promote Part Feature choice from the menu. 

3. Select or enter the features you want to promote to the part interface. Each 
promoted feature is given a name based on the variable name and the 
variable feature name. For example, if you promote the text attribute from 
an IEntryField variable named Selection, the promoted feature is named 
selectionText. 


Attributes - IVBVariablePart 


Figure 162. Attributes - IVBVariablePart. (S is Set, E is Event) 


Attribute 

S E 

Data type 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteT arget 

■ 

Boolean 

enabledForNotification 

■ 

Boolean 

targetPtr 


Element* 

this 

■ ■ 

Element 

BVariablePart 



Figure 163. Actions - IVBVariablePart 



Action 

Parameters 



disableNotification 
notifyObservers 
operator = 


INotificationId& nld 
IStandardNotifier& aStandardNotifier 
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Chapter 60. IVBVariablePartPointer 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM placeholder for part instance 

IVBVariablePartPointer 

IVBVariablePartBase 

Nonvisual part 

vbbase.vbb 


[n] 

FrameWindow2 


An IVBVariablePartPointer part is a placeholder for a pointer to part data. Visual 
Builder uses IVBVariablePartPointer when you specify a part pointer type, such as 
IEntryField*. for an IVBVariable. 

The user does not have access to these variables. 

Use an IVBVariable to pass data between composite parts. 


Building Guidelines - IVBVariablePartPointer 

Building guidelines for an IVBVariable are provided in documentation of 
IVBVariablePart. 


Attributes - IVBVariablePartPointer 

Figure 164. Attributes - IVBVariablePartPointer. (S is Set, E is Event) 


Attribute S E Data type 


asDebuglnfo 



IString 

asString 



IString 

autoDeleteT arget 

■ 


Boolean 

enabledForNotification 

■ 


Boolean 

targetPtr 



Element 

this 

■ 

■ 

Element 
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Actions - IVBVariablePartPointer 

Figure 165. Actions - IVBVariablePartPointer 

Action Parameters 

disableNotification 

notifyObservers INotificationId& nld 

operator = IStandardNotifier& aStandardNotifier 
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Chapter 61. IViewPort 

IBM view port to scroll nonresizable windows 
IViewPort 
ICanvas 
Visual part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 




An IViewPort part is a scrollable framework for the client area of a frame window. 

The user interacts with controls placed within the view port by your application. 

Use an IViewPort part to provide a scrollable view within a framework such as one 
of the following: 

• The client area of a frame window 

• A cell of a set canvas 

• A multicell canvas cell 

• A split canvas pane 

• A notebook page 


Building Guidelines - IViewPort 

When building with an IViewPort part, you can do the following: 
• Place one of the following canvases in the view port: 

- ICanvas 

- IMultiCellCanvas 

- ISetCanvas 

- ISplitCanvas 
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• Resize the canvas to fill the view port. Do this by selecting the canvas with 
mouse button 1 and dragging the corner handle to expand the canvas. This 
allows you to see the controls you place in the canvas. 


Attributes - IViewPort 

Figure 166 (Page 1 of 2). Attributes - IViewPort. (S is Set, E is Event) 


Attribute S E Data type 


activeColor 

■ ■ 

IColor 

asDebuglnfo 


IString 

asString 


IString 

autoDeleteObj ect 

■ 

Boolean 

autoDestroyWindow 

■ 

Boolean 

backgroundColor 

■ ■ 

IColor 

bidi Supported 


Boolean 

borderColor 

■ ■ 

IColor 

characterSize 


ISize 

defaultPushButton 


IWindowHandle 

disabledBackgroundColor 

■ ■ 

IColor 

disabledForegroundColor 

■ ■ 

IColor 

enabled 

■ ■ 

Boolean 

enabledForNotification 

■ 

Boolean 

focus 

■ 

Boolean 

font 

■ ■ 

IFont 

foregroundColor 

■ ■ 

IColor 

frame Window 


Boolean 

group 

■ 

Boolean 

handle 


IWindowHandle 

hiliteBackgroundColor 

■ ■ 

IColor 

hiliteForegroundColor 

■ ■ 

IColor 

horizontalScrollBar 


IScrollBar* 

id 

■ 

unsigned long 

inactiveColor 

■ ■ 

IColor 

itemProvider 

■ 

IDMItemProvider* 

lay out Adjustment 

menu 


IRectangle 

messageQueue 


IMessageQueueHandle 

minimumSize 

■ 

ISize 

nativeRect 


IRectangle 

origDefaultB uttonHandle 


IW indo wHandle 

owner 

■ 

Window* 

parent 

■ 

I Window* 

parents ize 


ISize 

pointerCaptured 


Boolean 

position 

■ ■ 

IPoint 

presSpace 


IPresSpaceHandle 

rect 

■ 

IRectangle 

shadowColor 

■ ■ 

IColor 

showing 


Boolean 

size 

■ ■ 

ISize 

tabStop 

■ 

Boolean 

valid 


Boolean 
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Figure 166 (Page 2 of 2). Attributes - IViewPort. (S is Set, E is Event) 

Attribute S E Data type 


verticalScrollBar 

viewWindow 

vie w Windo wDra wRectangle 
viewWindowSize 

visible 

visibleRectangle 


IScrollBar* 

IWindowHandle 

IRectangle 

ISize 

Boolean 

IRectangle 


Actions - IViewPort 

Figure 167 (Page 1 of 2). Actions - IViewPort 

Action Parameters 


apply B idi S ettings 

capturePointer 
con vertT oGUIS ty le 

disable 

disableGroup 

disableNotification 

disableTabStop 

disableUpdate 

dispatchRemainingHandlers 

enable 

enableUpdate 

handleException 

hide 

hideSourceEmphasis 

isLayoutDistorted 

matchForMnemonic 

notifyObservers 

positionBehindSibling 

positionBehindSiblings 

positionOnSiblings 

postEvent 

refresh 

releasePointer 

releasePresSpace 

resetActiveColor 

resetBackgroundColor 

resetBorderColor 

resetDisabledBackgroundColor 

resetDisabledForegroundColor 

resetFont 

resetForegroundColor 


BidiSettings& settings 
Boolean childlnherit=\me 
Boolean refresh- true 
Boolean capture=true. 
IBitFlag& style 
Boolean extendedOnly= false 


IEvent& event 
Boolean callDefProc= true 
Boolean enabled= true 
Boolean enableWindow=tme 
IException& dispatcherException 
IEvent& exceptionEvent 

unsigned long lay out Attribute 
unsigned short character 
INotificationEvent& event 
IWindowHandle& siblingWindow 

unsigned long eventld 
IEventParameterl& parm 1=0 
IEventParameter2& parm2= 0 
IRectangle& invalidRectangle 

IPresSpaceHandle& presentationSpaceHandle 


Chapter 61. IViewPort 497 




Figure 167 (Page 2 of 2). Actions - 

■ IViewPort 

Action 

Parameters 

resetHiliteB ackgroundColor 
resetHiliteForegroundColor 
resetlnactiveColor 

resetMinimumSize 

resetShadowColor 

scroll Vie wHorizontallyT o 

unsigned long leftOffset 

scroll Vie wV ertically T o 

unsigned long topOffset 

sendEvent 

unsigned long eventld 

setFocus 

setLayoutDistorted 

IEventParameter 1 & parml=0 

IEventParameter2& parm2= 0 

unsigned long lay out Attribute sOn 

show 

unsigned long lay outAttribute sOff 

Boolean visible=tme 

showSourceEmphasis 

Boolean show=\me 


Events - IViewPort 


Figure 168. Events - IViewPort 


Event 

Notification ID 

commandEvent 

commandld 

gotFocusEvent 

FOCUSTRUEID 

inputDisabledEvent 

ENABLEFALSEID 

inputEnabledEvent 

ENABLETRUEID 

lostFocusEvent 

FOCUSFALSEID 

systemCommandEvent 

systemCommandld 

visibilityDisabledEvent 

VISIBLEFALSEID 

visibilityEnabledEvent 

VISIBLETRUEID 

General Settings - IViewPort 


Name 


Sets the name of the part. 


Default value: The name of the part 

Width 


Sets the width of the window. 


Default value: 0 


Height 


Sets the height of the window. 


Default value: 0 
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Subpart name 

Sets the name of the subpart (a part placed on a composite part). 
Default value: The name of the part 


Control Settings - IViewPort 

Fly over short text 

Specifies the short text for the fly-over text control. 
Default value: None 
Fly over long text 

Specifies the long text for the fly-over text control. 
Default value: None 
Window id 

Sets the window identifier. 

Default value: None 
Help panel id 

Sets the help panel identifier for the part. 

Default value: None 
Enabled 

Enables the handler by default. 

Default value: Selected 


Styles Settings - IViewPort 

defaultStyleO 

Resets the part to the original default style. 

Default value: Selected 
noViewWindowFill 

If specified, the view port does not clear out the view window before redrawing as 
the window is scrolled. The view window assumes responsibility to repaint its 
entire rectangle. This can optimize redrawing the view window. 

Default value: The default is off, and the Default radio button is selected. 

clipChildren 

Excludes the area occupied by the children of the window when drawing in the 
window. Child windows are always “clipped” to their parent window. When a 
parent window is painted, the clipChildren style controls whether the invalidated 
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region of the parent window includes the area occupied by its children, thus 
preventing a window from painting over its child windows. 

Default value: The Default radio button is selected. 

clipSiblings 

Controls which sibling window is displayed on top when multiple siblings are 
displayed. Sibling windows are windows that share the same parent window. 
Assign the clipSiblings style to the sibling window that you want displayed on top 
of the other siblings, in Z-order. 

Default value: The Default radio button is selected. 

clipToParent 

Allows a window to paint outside of its window boundary up to the window 
boundary of its parent. 

Default value: The Default radio button is selected. 
saveBits 

Optimizes the painting of a window by saving the screen image of the area under 
the window as a bitmap and then using the bitmap to redraw the window, when 
necessary. 

Default value: The Default radio button is selected. 

synchPaint 

Synchronously repaints the window. Without this style, painting only occurs if 
there are no other events waiting to be processed. 

Default value: The Default radio button is selected. 

visible 

Makes the window visible. In general, controls are constructed as visible, and 
frame windows are constructed as invisible. 

Default value: The default is on, and the Default radio button is selected. 


Handlers Settings - IViewPort 

Handler name 

Sets the name of the default handler. 

Default value: None 
Handler list 

Sets the name of the handler for the MLE control. 
Default value: None 
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Add after 

Adds the new choice after the selected choice in the list. If no choice is selected, 
the new choice is added after the first choice in the list. 

Default value: Highlighted 

Add before 

Adds the new choice before the selected choice in the list. If no choice is selected, 
the new choice is added before the first choice in the list. 

Default value: Not highlighted 

Move 

Determines whether a part and its descendants can be moved to a new location. 
Default value: Not highlighted 
Remove 

Removes one item from the part and returns the count of the number of items that 
remain. 

Default value: Not highlighted 


Color Settings - IViewPort 

Color area 

Sets the color of the given area. Choices are as follows: 

Background 

Sets the color for background text 

Default value: Background is selected 
Color selection 

Enables color selection by either color values or RGB values. 

Select Colors or RGB. If you select Colors, you can set the Color values. If you 
select RGB, you can set the RGB values. 

Default value: Colors selected 

Color values 

Sets the color value of the window area, or sets the passed default if no color for 
the area has been set. 

Default value: None 

RGB values 

Sets the color values for the canvas. 

Default value: Red=255, Green=255, Blue=255 
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Size/Position Settings - IViewPort 

X field 

Sets the X coordinate of the part. 

Default value: The x coordinate of the part currently positioned on the free-form 
surface 

Y field 

Sets the Y coordinate of the point. 

Default value: The y coordinate of the part currently positioned on the free-form 
surface 

Width 

Sets the width of the text. 

Default value: None 
Height 

Sets the height of the text. 

Default value: None 
Minimum size 

Determines the minimum size of the part. 

Select Calculate at execution time or Set value here. If you select Calculate at 
execution time, the minimum size is determined dynamically. If you select Set 
value here, you can set the Minimum size Width and Height fields to define a 
fixed minimum size. 

Default value: Calculate at execution time is selected 
Width 

Sets the minimum-allowable width, which is set by the user’s class. 

Default value: None (calculated at execution time) 

Height 

Sets the minimum-allowable height, which is set by the user’s class. 

Default value: None (calculated at execution time) 
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Font Settings - IViewPort 

Name 

Sets the name of the font. 

Default value: System proportional 

Point size 

Sets the point size of the font. 

Default value: 10 
Style 

Sets the style for the part. 

Default value: None 
Emphasis 

Gives the part emphasis. If a part is specified, the emphasis is drawn around the 
part. 

Default value: None 
Edit 

Opens an edit field on a part or setting. 

Default value: Highlighted 
Default font 

Sets the current default font style. 

Default value: Not highlighted 
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Chapter 62. IVSequence 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM VSequence template collection class 

IVSequence 

IVGSequence 

Nonvisual part 

vbbase.vbb 



Sequence 


An IVSequence part is an ordered collection of elements. 

The user interacts with objects in the collection through other parts, such as list boxes 
and combination boxes. The user does not interact directly with an IVSequence part. 

Use an IVSequence part to manage objects in an ordered collection. 


Building Guidelines - IVSequence 

When building with an IVSequence part, you can do the following: 

• Define the type of objects in the sequence. Do this by entering a pointer to the 
part type (part type and *) in the Item type field on the IVSequence General 
settings page. 

• Identify initial objects in the collection. Do this by entering the choices in the 
Contents field on the IVSequence General settings page. 

• Add a given object to the collection when a push button is pressed. Do this by 
connecting the IPushButton buttonClickEvent feature to the IVSequence add 
action. Then, connect the this attribute of the object to the 

buttonClickEvent-to-add connection, providing the element parameter for the add 
action. 

• Add an object with a known attribute value to the collection when a push button 
is pressed. For example, add a key attribute value representing an object to an 
ICollectionViewComboBox part when the user enters the attribute in the 
combination box entry field and presses an Add push button. Do this by 
connecting the IPushButton buttonClickEvent feature to an add action of a 
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nonvisual object manager part. Then, connect the object text attribute to the 
buttonClickEvent-to-add connection, providing the attribute parameter for the add 
action. 

The nonvisual object manager could either find an existing object with the key 
attribute value or create a new object with the key. To add the object to the 
sequence, the object manager part could either call the IVSequence add function 
or generate an event that you can connect to the IVSequence add action, passing 
the object as the element parameter. 

• Remove an object with a known index from the collection when a push button is 
pressed. For example, remove a selected object item from an 
ICollectionViewComboBox part when the user presses a Remove push button. 

Do this by connecting the IPushButton buttonClickEvent feature to the 
IVSequence removeAtPosition action. Then, connect the 
ICollectionViewComboBox selection attribute to the 
buttonClickEvent-to-removeAtPosition connection, providing the position 
parameter for the removeAtPosition action. 


Attributes - IVSequence 


Figure 169. Attributes - IVSequence. 

(S is Set, E is Event) 


Attribute 

S E 

Data type 

anyElement 


Element const& 

base 


Base& 

bounded 


IBoolean 

consistent 


IBoolean 

empty 


IBoolean 

enabledForNotification 

■ 

Boolean 

firstElement 


Element const& 

full 


IBoolean 

lastElement 


Element const& 

maxNumberOfElements 


INumber 

newCursor 


ICursor* 

numberOfElements 


INumber 


Actions - IVSequence 

Figure 170 (Page 1 of 2). Actions - IVSequence 

Action Parameters 


add 

addAllFrom 

addAsFirst 

addAsLast 

addAtPosition 


Element const& 

ICursor& 

IACollection < Element > const& 
Element const& 

Element const& 

ICursor& 

IPosition 
Element const& 
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Figure 170 (Page 2 of 2). Actions ■ 

■ IVSequence 

Action 

Parameters 

allElementsDo 

IBoolean ( * function ) ( Element& 
void * ) , void* additionalArgument =0 

compare 

IASequence < Element > const& 

long ( * comparisonFunction ) ( Element const & , Element 
const & ) 

copy 

disableNotification 

IACollection < Element > const& 

elementAtPosition 

IPosition 

operator = 

IVSequenceOnBase < Element 

Base > const& c 

removeAll 

IBoolean ( * property ) ( Element const& 
void * ) , void* additionalArgument =0 

removeAtPosition 

removeFirst 

removeLast 

IPosition 

sort 

long ( * comparisonFunction ) ( Element const & , Element 
const & ) 


Events - IVSequence 


Figure 171. Events - IVSequence 


Event 

Notification ID 

addedEvent 

addedld 

modifiedEvent 

modifiedld 

removedEvent 

removedld 

replacedEvent 

replacedld 

General Settings - IVSequence 


Subpart name 


Sets the name of the subpart (a part placed on a composite part). 

Default value: The name of the part 

Item type 


Specifies the part type of objects in 

the collection. 


Default value: None 


Contents 

Sets initial items for the part. 
Default value: None 
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Part 3. Class Interface Parts 


The following chapters provide information on all class interface parts except those 
on the parts palette. Class interface parts are not fully enabled parts. 


Chapter 63. IOString . 511 

Chapter 64. I Accelerator . 515 

Chapter 65. ICLibErrorlnfo . 517 

Chapter 66. IClipboard . 519 

Chapter 67. I Color . 521 

Chapter 68. IContainerObject . 523 

Chapter 69. IDate . 525 

Chapter 70. IDynamicLinkLibrary . 527 

Chapter 71. IFlyOverHelpHandler . 529 

Chapter 72. IFont . 531 

Chapter 73. IGUIErrorlnfo . 533 

Chapter 74. I Handle . 535 

Chapter 75. IMM24FramesPerSecondTime . 537 

Chapter 76. IMM25FramesPerSecondTime . 539 

Chapter 77. IMM30FramesPerSecondTime . 541 

Chapter 78. IMMAudioBuffer . 543 

Chapter 79. IMMAudioCDContents . 545 

Chapter 80. IMMAudioHeader . 547 

Chapter 81. IMMErrorlnfo . 549 


© Copyright IBM Corp. 1995 


509 






















Chapter 82. IMMHourMinSecFrameTime . 551 

Chapter 83. IMMHourMinSecTime . 553 

Chapter 84. IMMMillisecondTime . 555 

Chapter 85. IMMMinSecFrameTime . 557 

Chapter 86. IMMSpeed . 559 

Chapter 87. IMMTime 561 

Chapter 88. IMMTrackMinSecFrameTime . 563 

Chapter 89. IPair . 565 

Chapter 90. IPercentAvailable . 567 

Chapter 91. IPoint . 569 

Chapter 92. IPointArray . 571 

Chapter 93. I Profile . 573 

Chapter 94. I Range . 575 

Chapter 95. I Rectangle . 577 

Chapter 96. IResourceld . 579 

Chapter 97. IResourceLibrary . 581 

Chapter 98. ISize . 583 

Chapter 99. IString . 585 

Chapter 100. ISystemErrorlnfo . 589 

Chapter 101. ITime . 591 

Chapter 102. ITrace . 593 
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Chapter 63. lOString 

Title: 

Class name: 
Base part: 

Part type: 

Part file: 


IBM string class, indexed starting at 0 

lOString 

IString 

Class interface part 
vbbase.vbb 


Attributes - lOString 

Figure 172. Attributes - lOString. (S is Set) 

Attribute S Data type 


alphabetic 

alphanumeric 

asDebuglnfo 

asDouble 

aslnt 

asString 

asUnsigned 

binaryDigits 

control 

digits 

graphics 

hexDigits 

includesDBCS 

includesMBCS 

includesSBCS 

isASCII 

isDBCS 

isLowerCase 

isMBCS 

isSBCS 

isUpperCase 

length 

numWords 

printable 

punctuation 

size 

validDBCS 

validMBCS 

whiteSpace 


Boolean 

Boolean 

IString 

double 

long 

IString 

unsigned long 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

Boolean 

unsigned 

unsigned 

Boolean 

Boolean 

unsigned 

Boolean 

Boolean 

Boolean 
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Actions - lOString 

Figure 173 (Page 1 of 3). Actions - lOString 

Action Parameters 


b2c 

b2d 

b2x 

c2b 

c2d 

c2x 

center 


change 


charType 

copy 

d2b 

d2c 

d2x 

includes 

indexOf 

indexOfAnyBut 

indexOfAnyOf 

indexOfPhrase 

indexOfW ord 

insert 


isAbbreviationFor 

isLike 


lastlndexOf 
lastlndexOfAny B ut 
lastlndexOfAnyOf 
leftJustify 
lengthOfWord 


IString& aString 
IString& aString 
IString& aString 


IString& aString 
IString& aString 
unsigned length 
char padCharacter= ' 

IString& aString 
IString& inputString 
IString& outputstring 
unsigned startPos =0 

unsigned numChanges=( unsigned ) UINT_MAX 

unsigned index 

IString& aString 

unsigned numCopies 

IString& aString 


IStringTest& aTest 
char* pString 
unsigned startPos= 1 
IString& validChars 
unsigned startPos= 1 
IStringTest& aTest 
unsigned startPos= 1 
IString& wordString 
unsigned startWord— 1 
unsigned wordNumber 
IString& aString 
IString& anlnsert 

unsigned index={ unsigned ) UINT_MAX 

char padCharacter= ' 

char* pFullString 

unsigned minAbbrevLength=0 

char* pPattern 

unsigned patternLen 

char zcroOrMore 

char anyChar 

char aCharacter 

unsigned startPos=( unsigned ) UINT_MAX 
IStringTest& aTest 

unsigned startPos={ unsigned ) UINT_MAX 
IString& searchChars 

unsigned startPos=( unsigned ) UINT_MAX 
unsigned length 
char padCharacter= ' 
unsigned wordNumber 
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Figure 173 (Page 2 of 3). Actions - IOString 

Action Parameters 


lineFrom 

lowerCase 

occurrencesOf 


operator & 
operator &= 
operator + 
operator += 
operator = 
operator char * 
operator signed char * 
operator unsigned char 
operator [] 
operator ^ 
operator /v = 
operator I 
operator 1= 
operator ~ 
overlay With 


remove 


remove Words 

reverse 

rightJustify 

space 

strip 

stripBlanks 

stripLeading 

stripLeadingBlanks 

stripTrailing 

stripTrailingBlanks 

substring 

translate 


uppercase 

word 

wordlndexOfPhrase 


istream& aStream 
char delim=\ n' 
IString& aString 
char* pSearchString 
unsigned searchLen 
unsigned startPos 
IString& aString 
char* pString 
IString& aString 
char* pString 
IString& aString 


unsigned index 
IString& aString 
char* pString 
IString& aString 
char* pString 

IString& aString 
char* pOverlay 
unsigned index- 0 
char padCharacter= ' 
IString& aString 
unsigned startPos 
unsigned numChars 
unsigned firstWord 
unsigned numWords 
IString& aString 
unsigned length 
char padCharacter= ' 
unsigned numSpaces— 1 
char spaceChar= ' 
IString& aString 
char aChar 
IString& aString 
IString& aString 
char* pStringOfChars 
IString& aString 
IString& aString 
IStringTest& aTest 
IString& aString 
unsigned startPos 
IString& inputChars 
IString& outputChars 
char padCharacter= ' 
IString& aString 
unsigned wordNumber 
IString& aPhrase 
unsigned startWord= 1 
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Figure 173 (Page 3 of 3). Actions - lOString 


Action 

Parameters 

words 

unsigned firstWord 


unsigned numWords 

x2b 


x2c 

IString& aString 

x2d 

IString& aString 
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Chapter 64. (Accelerator 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM class to access shortcut-key table 
lAccelerator 

IBase 

Class interface part 
vbbase.vbb 

Attributes - lAccelerator 

Figure 174. Attributes 

- lAccelerator. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asString 

IString 

handle 

IAccelTblHandle 

isSet 

Boolean 

owner 

IWindow* 

Actions - lAccelerator 

Figure 175. Actions - lAccelerator 

Action 

Parameters 


remove 

reset 

set IAccelTblHandle& haccel 

unset 
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Chapter 65. ICLibErrorlnfo 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM access to CLib error 

ICLibErrorlnfo 

IErrorlnfo 

Class interface part 
vbbase.vbb 

information 

Attributes - ICLibErrorlnfo 

Figure 176. Attributes - 

ICLibErrorlnfo. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

available 


Boolean 

errorld 


unsigned long 

text 


const char* 

Actions - ICLibErrorlnfo 

Figure 177. Actions - ICLibErrorlnfo 


Action 

Parameters 


operator const char * 

throwCLibError 


throwError 


char* functionName 
IExceptionLocation& location 
IErrorlnfo: :ExceptionType name= accessError 
IException:: Severity severity^ recoverable 
IExceptionLocation& location 
IErrorlnfo: :ExceptionType name=accessError 
IException::Severity .severify=recoverable 
IException::Severity s^venYy^ecoverable 
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Chapter 66. IClipboard 

IBM clipboard class 
IClipboard 
IVBase 

Class interface part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


Attributes - IClipboard 


Figure 178. Attributes - IClipboard. (S is Set) 

Attribute 

S 

Data type 

asDebuglnfo 


IString 

asString 


IString 

bitmap 

■ 

IBitmapHandle 

formatCount 


unsigned long 

hasBitmap 


Boolean 

hasText 


Boolean 

isOpen 


Boolean 

owner 


IWindowHandle 

primaryFormat 


IString 

text 

■ 

IString 


Actions - IClipboard 

Figure 179. Actions - IClipboard 

Action Parameters 

close 

data char* format 

empty 

format Cursor& cursor 

formatAsHandle char* format 

hasData char* format 

open 

registerFormat char* private Format 

setData char* format 

void* data 

unsigned long dataLength 

setHandle const char* format 

unsigned long handle 
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Chapter 67. IColor 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM color class 

IColor 

IVBase 

Class interface part 
vbbase.vbb 


Attributes - IColor 


Figure 180. Attributes - IColor. (S is Set) 


Attribute 

S 

Data type 

asDebuglnfo 


IString 

asRGBLong 


long 

asString 


IString 

blueMix 

■ 

unsigned char 

greenMix 

■ 

unsigned char 

index 


long 

redMix 

■ 

unsigned char 

value 


Color 

3lor 



Figure 181. Actions - IColor 



Action 

Parameters 


operator != 
operator = 
operator == 


IColor& color 
IColor& color 
IColor& color 
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Chapter 68. IContainerObject 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM base class for all container items 

IContainerObj ect 

IVBase 

Class interface part 
vbbase.vbb 


Attributes - IContainerObject 


Figure 182. Attributes ■ 

■ IContainerObject. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

dropOnAble 

■ 

Boolean 

helpld 


unsigned long 

icon 

■ 

IPointerHandle 

iconText 

■ 

IString 

inUse 

■ 

Boolean 

objectCopy 


IContainerObject* 

open 

■ 

Boolean 

refreshOn 

■ 

Boolean 

visible 

■ 

Boolean 

writeable 

■ 

Boolean 


Actions - IContainerObject 


Figure 183 (Page 1 of 2). Actions ■ 

■ IContainerObject 

Action 

Parameters 

disableDataUpdate 

IContainerControl* containers 0 

disableDrop 

IContainerControl* containers 0 

handleCursoredChange 

IContainerControl* container 

handlelnuseChange 

Boolean acquired 

IContainerControl* container 

handleOpen 

Boolean acquired 

IContainerControl* container 

handleSelectedChange 

IContainerControl* container 

handleT reeColIapse 

Boolean acquired 

IContainerControl* container 

handleT reeExpand 

IContainerControl* container 

hide 

IContainerControl* containers 0 

operator == 

IContainerObj ect& object 

operator delete 

void * 

operator new 

refresh 

const char* fileName 
size_t lineNumber 

IContainerControl* containers 0 

removelnUse 

IContainerControl* containers 0 
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Figure 183 (Page 2 of 2). Actions - IContainerObject 

Action Parameters 

setClosed 

setRefreshOff 
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Chapter 69. IDate 



Title: 

IBM date class 


Class name: 

IDate 


Base part: 

IBase 


Part type: 

Class interface part 


Part file: 

vbbase.vbb 


Attributes - IDate 



Figure 184. Attributes ■ 

■IDate. (S is Set) 


Attribute 

s 

Data type 

asCDATE 


_CDATE 

asDebuglnfo 


IString 

asString 


IString 

dayOfMonth 


int 

dayOfWeek 


DayOfW eek 

dayOfY ear 


int 

julianDate 


unsigned long 

monthOfY ear 


Month 

today 


IDate 

year 


int 

Actions - IDate 


Figure 185. Actions - IDate 

Action 

Parameters 

dayName 

DayOfWeek aDay 

daysInMonth 

Month aMonth 


int aYear 

daysInYear 

int aYear 

isLeapYear 

int aYear 

is Valid 

int aDay 


Month aMonth 


int aYear 

monthName 

Month aMonth 

operator != 

IDate& aDate 

operator + 

int numDays 

operator += 

int numDays 

operator - 

IDate& aDate 

operator -= 

int numDays 

operator < 

IDate& aDate 

operator <= 

IDate& aDate 

operator == 

IDate& aDate 

operator > 

IDate& aDate 

operator >= 

IDate& aDate 
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Chapter 70. IDynamicLinkLibrary 


Title: 

IBM support for linking to DLL 

Class name: 

IDynamicLinkLibrary 

Base part: 

IResourceLibrary 

Part type: 

Class interface part 

Part file: 

vbbase.vbb 

Attributes - IDynamicLinkLibrary 

Figure 186. Attributes ■ 

■ IDynamicLinkLibrary. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asString 

IString 

fileName 

IString 

handle 

IModuleHandle 

Actions - IDynamicLinkLibrary 


Figure 187 (Page 1 of 2). Actions ■ 

■ IDynamicLinkLibrary 

Action 

Parameters 

close 

isEntryPoint32Bit 

unsigned long procedureOrdinal 

loadAccelTable 

unsigned long accelTableld 

loadBitmap 

unsigned long bitmapld 

Boolean cached= true 

loadDialog 

unsigned long dialogld 

Window* dialogParent 

IWindow* dialogOwner 

IWinProc* dialogProcedure 
void* dialogCreateParameters 

loadHelpTable 

IWindow* helplnstance 
unsigned long helpTableld 

loadlcon 

unsigned long iconld 

Boolean cached= true 

loadMenu 

unsigned long menuld 

IWindow* menuOwner 

loadMessage 

unsigned long messageld 

loadPointer 

unsigned long iconld 

Boolean cached=\mz 

loadString 

open 

unsigned long stringld 

operator - 

IResourceLibrary& resLibrary 

procAddress 

char* procedureName 

try ToLoadB itmap 

unsigned long bitmapld 

ISize& bitmap Size 

Boolean cached= true 

tryToLoadlcon 

unsigned long iconld 


© Copyright IBM Corp. 1995 


527 



Figure 187 (Page 2 of 2). Actions -1DynamicLinkLibrary 

Action Parameters 


tryToLoadMessage 
try T oLoadS tring 


Boolean cached= true 
unsigned long messageld 
unsigned long stringld 
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Chapter 71. IFIyOverHelpHandler 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM handler class for fly-over help 

IFIyOverHelpHandler 

IHandler 

Class interface part 
vbbase.vbb 


Attributes - IFIyOverHelpHandler 


Figure 188. Attributes - IFIyOverHelpHandler. (S is Set) 


Attribute 

S 

Data type 

asDebuglnfo 


IString 

asString 


IString 

defaultText 

■ 

IString 

delayTime 

■ 

unsigned long 

enabled 

■ 

Boolean 

flyTextControl 

■ 

IFlyText* 

fly T extStringT ableOffset 

■ 

long 

longStringTableOffset 

■ 

long 

longTextControl 

■ 

ITextControl* 

resourceLibrary 

■ 

IResourceLibrary& 

yOverHelpHandler 



Figure 189. Actions - IFIyOverHelpHandler 



Action 

Parameters 


disable 

flyHelpText 
longHelpText 
remo veHelpT ext 
setHelpText 


start 

stop 


IWindowHandle& handle 
IWindowHandle& handle 
IWindowHandle& handle 
IWindowHandle& handle 
IString& flyText 
IString& longText=lString ( ) 
Window* window 
IWindow* window 
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Chapter 72. IFont 

Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM class to manage fonts 

IFont 

IVBase 

Class interface part 
vbbase.vbb 


Attributes - IFont 


Figure 190. Attributes - IFont. (S is Set) 


Attribute 

S 

Data type 

asDebuglnfo 


IString 

asString 


IString 

avgCharWidth 


unsigned long 

avgLowercase 


unsigned long 

avgUppercase 


unsigned long 

bitmap 


Boolean 

bitmapOnly 


Boolean 

bold 

■ 

Boolean 

externalLeading 


unsigned long 

fattrs 


const struct _FATTRS* 

fixed 


Boolean 

fontmetrics 


const struct _FONTMETRICS* 

internalLeading 


unsigned long 

italic 

■ 

Boolean 

maxAscender 


unsigned long 

maxCharHeight 


unsigned long 

maxDescender 


unsigned long 

maxLowercaseAscender 


unsigned long 

maxLowercaseDescender 


unsigned long 

maxSize 


ISize 

maxU ppercaseSize 


ISize 

name 

■ 

IString 

nonPropOnly 


Boolean 

outline 

■ 

Boolean 

pointSize 

■ 

unsigned long 

strikeout 

■ 

Boolean 

subscriptOffset 


ISize 

subscriptSize 


ISize 

superscriptOffset 


ISize 

superscriptSize 


ISize 

underscore 

■ 

Boolean 

vectorOnly 


Boolean 
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Actions - IFont 


Figure 191. Actions - IFont 


Action 

Parameters 

beginUsingFont 

IPresSpaceHandle& presSpaceHandle 

eharWidth 

char c 

endUsingFont 

IPresSpaceHandle& presSpaceHandle 

minTextWidth 

char* line 

operator = 

IFont& rhs 

setAHEmphasis 

Boolean turnOn= true 

setCharHeight 

unsigned long height 

IPresSpaceHandle& presSpaceHandle=lPresSpaceHand\e ( 

) 

ISize& size 

IPresSpaceHandle& presSpaceHandle=IPresSpaceHand\e ( 

) 

unsigned long width 

IPresSpaceHandle& presSpaceHandle=lPresSpaceHand\e ( 

) 

Direction direction 

setCharSize 

setCharWidth 

setDirection 

setFontAngle 

IPoint& point 

IPresSpaceHandle& presSpaceHandle=lPresSpaceHand\e ( 

) 

IPoint& point 

IPresSpaceHandle& presSpaceHandle=lPresSpaceHand\e ( 

) 

IWindow* window 

setFontShear 

setWindowFont 

textLines 

char* text 

unsigned long lineWidth 

textWidth 

char* text 

useBitmapOnly 

Boolean bitmap Only =true 

IPresSpaceHandle& presSpaceHandle=lPresSpaceHand\e ( 

) 

Boolean nonProportionalOnly=tme 

IPresSpaceHandle& presSpaceHandle=lPresSpaceHand\e ( 

) 

Boolean vectorOnly= true 

IPresSpaceHandle& presSpaceHandle=lPresSpaceHand\e ( 

) 

useNonPropOnly 

useVectorOnly 
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Chapter 73. IGUIErrorlnfo 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM access to GUI error information 

IGUIErrorlnfo 

IErrorlnfo 

Class interface part 
vbbase.vbb 

Attributes - IGUIErrorlnfo 

Figure 192. Attributes 

- IGUIErrorlnfo. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asString 

IString 

available 

Boolean 

errorld 

unsigned long 

text 

const char* 

Actions - IGUIErrorlnfo 

Figure 193. Actions - IGUIErrorlnfo 

Action 

Parameters 


operator const char * 
throwError 


throwGUIError 


IExceptionLocation& location 
IErrorlnfo: :ExceptionType name=accessError 
IException:: Severity severity=recovemb\e 
IException:: Severity severity=recovemb\e 
char* functionName 
IExceptionLocation& location 
IErrorlnfo: :ExceptionType name= accessError 
IException::Severity severity^ recoverable 
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Chapter 74. IHandle 


Title: 

IBM abstract class for all handles 

Class name: 

IHandle 

Base part: 

IBase 

Part type: 

Class interface part 

Part file: 

vbbase.vbb 

Attributes - IHandle 


Figure 194. Attributes ■ 

- IHandle. (S is Set) 


Attribute 

S 

Data type 

asDebuglnfo 


IString 

asString 


IString 

asUnsigned 


unsigned long 


Actions - IHandle 


Figure 195. Actions - IHandle 

Action Parameters 

operator Value 
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Chapter 75. IMM24FramesPerSecondTime 

Title: IBM support of 24-frames-per-second video 

Class name: IMM24FramesPerSecondTime 

Base part: IMMHourMinSecFrameTime 

Part type: Class interface part 

Part file: vbmm.vbb 

Attributes - IMM24FramesPerSecondTime 


Figure 196. Attributes ■ 

■ IMM24FramesPerSecondTime. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asMMTime 

unsigned long 

asString 

IString 

frames 

unsigned long 

framesPerSecond 

unsigned long 

hours 

unsigned long 

hundredths 

unsigned long 

minutes 

unsigned long 

ordinal 

unsigned long 

seconds 

unsigned long 

thousandths 

unsigned long 

valid 

Boolean 


Actions - IMM24FramesPerSecondTime 

Figure 197. Actions - IMM24FramesPerSecondTime 

Action Parameters 

operator != 
operator + 
operator += 
operator - 
operator -= 
operator < 
operator <= 
operator - 
operator == 
operator > 
operator >= 
operator unsigned long 
setTimeToOrdinal 


IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 

unsigned long ordinal 
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Chapter 76. IMM25FramesPerSecondTime 

Title: IBM support of 25-frames-per-second video 

Class name: IMM25FramesPerSecondTime 

Base part: IMMHourMinSecFrameTime 

Part type: Class interface part 

Part file: vbmm.vbb 

Attributes - IMM25FramesPerSecondTime 


Figure 198. Attributes ■ 

■ IMM25FramesPerSecondTime. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asMMTime 

unsigned long 

asString 

IString 

frames 

unsigned long 

framesPerSecond 

unsigned long 

hours 

unsigned long 

hundredths 

unsigned long 

minutes 

unsigned long 

ordinal 

unsigned long 

seconds 

unsigned long 

thousandths 

unsigned long 

valid 

Boolean 


Actions - IMM25FramesPerSecondTime 

Figure 199. Actions - IMM25FramesPerSecondTime 

Action Parameters 

operator != 
operator + 
operator += 
operator - 
operator -= 
operator < 
operator <= 
operator - 
operator == 
operator > 
operator >= 
operator unsigned long 
setTimeToOrdinal 


IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 

unsigned long ordinal 
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Chapter 77. IMM30FramesPerSecondTime 

Title: IBM support of 30-frames-per-second video 

Class name: IMM30FramesPerSecondTime 

Base part: IMMHourMinSecFrameTime 

Part type: Class interface part 

Part file: vbmm.vbb 

Attributes - IMM30FramesPerSecondTime 


Figure 200. Attributes ■ 

■ IMM30FramesPerSecondTime. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asMMTime 

unsigned long 

asString 

IString 

frames 

unsigned long 

framesPerSecond 

unsigned long 

hours 

unsigned long 

hundredths 

unsigned long 

minutes 

unsigned long 

ordinal 

unsigned long 

seconds 

unsigned long 

thousandths 

unsigned long 

valid 

Boolean 


Actions - IMM30FramesPerSecondTime 

Figure 201. Actions - IMM30FramesPerSecondTime 

Action Parameters 

operator != 
operator + 
operator += 
operator - 
operator -= 
operator < 
operator <= 
operator - 
operator == 
operator > 
operator >= 
operator unsigned long 
setTimeToOrdinal 


IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 
IMMTime& time 

unsigned long ordinal 
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Chapter 78. IMMAudioBuffer 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM audio buffer 
IMMAudioBuffer 
IBase 

Class interface part 
vbmm.vbb 


Attributes - IMMAudioBuffer 


Figure 202. Attributes ■ 

■ IMMAudioBuffer. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

bitsPerSample 

■ 

unsigned long 

blockAIignment 

■ 

unsigned long 

bytesPerSecond 

■ 

unsigned long 

channels 

■ 

unsigned long 

contentType 

■ 

ContentType 

data 

■ 

IString 

format 

■ 

Format 

headerData 


IString 

length 


unsigned long 

mediaType 

■ 

unsigned long 

sampiesPerSecond 

■ 

unsigned long 


Actions - IMMAudioBuffer 

Figure 203. Actions - IMMAudioBuffer 

Action Parameters 


operator = IMMAudioBuffer& audioBuffer 
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Chapter 79. IMMAudioCDContents 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM table of contents for audio compact disc 
IMMAudioCDContents 

IVBase 

Class interface part 
vbmm.vbb 

Attributes - IMMAudioCDContents 


Figure 204. Attributes 

- IMMAudioCDContents. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

discld 


IString 

mimberOfEntries 


unsigned long 

numberOfTracks 


unsigned long 

valid 


Boolean 

Actions - IMMAudioCDContents 


Figure 205. Actions - IMMAudioCDContents 


Action 

Parameters 


addEntryAsFirst unsigned long trackNumber 

operator = IMMAudioCDContents& newContents 
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Chapter 80. IMMAudioHeader 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM audio header 
IMMAudioHeader 
IVBase 

Class interface part 
vbmm.vbb 


Attributes - IMMAudioHeader 


Figure 206. Attributes - IMMAudioHeader. 

(S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

averageBytesPerSecond 

■ 

unsigned long 

bitsPerSample 

■ 

unsigned long 

blockAlign 

■ 

unsigned long 

channels 

■ 

unsigned long 

contentType 

■ 

ContentType 

formatTag 

■ 

FormatTag 

headerData 


const void* 

sampiesPerSecond 

■ 

unsigned long 


Actions - IMMAudioHeader 

Figure 207. Actions - IMMAudioHeader 

Action Parameters 


operator = IMMAudioHeader& audHead 
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Chapter 81. IMMErrorlnfo 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM multimedia error information 

IMMErrorlnfo 

IErrorlnfo 

Class interface part 
vbmm.vbb 

Attributes - IMMErrorlnfo 

Figure 208. Attributes 

- IMMErrorlnfo. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asString 

IString 

available 

Boolean 

errorld 

unsigned long 

text 

const char* 

Actions - IMMErrorlnfo 

Figure 209. Actions - IMMErrorlnfo 

Action 

Parameters 


operator const char * 

throwError IExceptionLocation& location 

IErrorlnfo: :ExceptionType name=accessExxox 
IException:: Severity severity=recovemb\e 
IException:: Severity sev^nYy^ecoverable 
throwMMError unsigned long errorld 

char* functionName 
IExceptionLocation& location 
IErrorlnfo: :ExceptionType name=accessExxox 
IException::Severity sev^nYy^ecoverable 


© Copyright IBM Corp. 1995 


549 



550 Visual Builder Parts Reference 



Chapter 82. IMMHourMinSecFrameTime 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM support of hour/minute/second/frame time format 
IMMHourMinSecFrameTime 

IMMTime 

Class interface part 
vbmm.vbb 

Attributes - IMMHourMinSecFrameTime 


Figure 210. Attributes ■ 

■ IMMHourMinSecFrameTime. 

(S is Set) 

Attribute 

s 

Data type 

asDebuglnfo 


IString 

asMMTime 


unsigned long 

asString 


IString 

frames 


unsigned long 

framesPerSecond 


unsigned long 

hours 


unsigned long 

hundredths 


unsigned long 

minutes 


unsigned long 

ordinal 


unsigned long 

seconds 


unsigned long 

thousandths 


unsigned long 

valid 


Boolean 

Actions - IMMHourMinSecFrameTime 


Figure 211. Actions - IMMHourMinSecFrameTime 

Action 

Parameters 


operator != 

IMMTime& 

time 

operator + 

IMMTime& 

time 

operator += 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator -= 

IMMTime& 

time 

operator < 

IMMTime& 

time 

operator <= 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator == 

IMMTime& 

time 

operator > 

IMMTime& 

time 

operator >= 

IMMTime& 

time 

operator unsigned long 



setTimeT oOrdinal 

unsigned long ordinal 
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Chapter 83. IMMHourMinSecTime 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM support of hour/minute/second time format 

IMMHourMinSecTime 

IMMTime 

Class interface part 

vbmm.vbb 


Attributes - IMMHourMinSecTime 


Figure 212. Attributes - IMMHourMinSecTime. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asMMTime 


unsigned long 

asString 


IString 

hours 


unsigned long 

hundredths 


unsigned long 

minutes 


unsigned long 

ordinal 


unsigned long 

seconds 


unsigned long 

thousandths 


unsigned long 

valid 


Boolean 


Actions - IMMHourMinSecTime 


Figure 213. Actions - IMMHourMinSecTime 


Action 

Parameters 


operator != 

IMMTime& 

time 

operator + 

IMMTime& 

time 

operator += 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator -= 

IMMTime& 

time 

operator < 

IMMTime& 

time 

operator <= 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator == 

IMMTime& 

time 

operator > 

IMMTime& 

time 

operator >= 

IMMTime& 

time 

operator unsigned long 



setTimeT oOrdinal 

unsigned long ordinal 
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Chapter 84. IMMMillisecondTime 


Title: 

IBM millisecond time class 


Class name: 

IMMMillisecondTime 


Base part: 

IMMTime 


Part type: 

Class interface part 


Part file: 

vbmm.vbb 


Attributes - IMMMillisecondTime 


Figure 214. Attributes ■ 

■ IMMMillisecondTime. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asMMTime 


unsigned long 

asString 


IString 

hours 


unsigned long 

hundredths 


unsigned long 

minutes 


unsigned long 

ordinal 


unsigned long 

seconds 


unsigned long 

thousandths 


unsigned long 

valid 


Boolean 

Actions - IMMMillisecondTime 


Figure 215. Actions - IMMMillisecondTime 

Action 

Parameters 


operator != 

IMMTime& 

time 

operator + 

IMMTime& 

time 

operator += 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator -= 

IMMTime& 

time 

operator < 

IMMTime& 

time 

operator <= 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator == 

IMMTime& 

time 

operator > 

IMMTime& 

time 

operator >= 

IMMTime& 

time 

operator unsigned long 



setTimeT oOrdinal 

unsigned long ordinal 
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Chapter 85. IMMMinSecFrameTime 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM support of minute/second/frame time format 

IMMMinSecFrameTime 

IMMTime 

Class interface part 

vbmm.vbb 


Attributes - IMMMinSecFrameTime 


Figure 216. Attributes - IMMMinSecFrameTime. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asMMTime 


unsigned long 

asString 


IString 

frames 


unsigned long 

hours 


unsigned long 

hundredths 


unsigned long 

minutes 


unsigned long 

ordinal 


unsigned long 

seconds 


unsigned long 

thousandths 


unsigned long 

valid 


Boolean 


Actions - IMMMinSecFrameTime 


Figure 217. Actions - IMMMinSecFrameTime 


Action 

Parameters 


operator != 

IMMTime& 

time 

operator + 

IMMTime& 

time 

operator += 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator -= 

IMMTime& 

time 

operator < 

IMMTime& 

time 

operator <= 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator == 

IMMTime& 

time 

operator > 

IMMTime& 

time 

operator >= 

IMMTime& 

time 

operator unsigned long 



setTimeT oOrdinal 

unsigned long ordinal 
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Chapter 86. IMMSpeed 

IBM speed class 
IMMSpeed 
IVBase 

Class interface part 
vbmm.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


Attributes - IMMSpeed 

Figure 218. Attributes - IMMSpeed. (S is Set) 

Attribute S 

asDebuglnfo 

asString 

format 

speed 


Data type 

IString 
IString 
Format 
unsigned long 
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Chapter 87. IMMTime 

Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM base class for all multimedia time support 

IMMTime 

IVBase 

Class interface part 
vbmm.vbb 

Attributes - IMMTime 



Figure 219. Attributes - 

■ IMMTime. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asMMTime 


unsigned long 

asString 


IString 

hours 


unsigned long 

hundredths 


unsigned long 

minutes 


unsigned long 

ordinal 


unsigned long 

seconds 


unsigned long 

thousandths 


unsigned long 

valid 


Boolean 

Actions - IMMTime 


Figure 220. Actions - IMMTime 

Action 

Parameters 


operator != 

IMMTime& 

time 

operator + 

IMMTime& 

time 

operator += 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator -= 

IMMTime& 

time 

operator < 

IMMTime& 

time 

operator <= 

IMMTime& 

time 

operator = 

IMMTime& 

time 

operator == 

IMMTime& 

time 

operator > 

IMMTime& 

time 

operator >= 

IMMTime& 

time 

operator unsigned long 



setTimeToOrdinal 

unsigned long ordinal 
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Chapter 88. IMMTrackMinSecFrameTime 


Title: 

Class name: 
Base part: 

Part type: 

Part file: 

IBM support of track/minute/second/frame time format 
IMMTrackMinSecFrameTime 

IMMTime 

Class interface part 
vbmm.vbb 

Attributes - IMMTrackMinSecFrameTime 


Figure 221. Attributes - IMMTrackMinSecFrameTime. 

(S is Set) 

Attribute 

S 

Data type 

asDebuglnfo 


IString 

asMMTime 


unsigned long 

asString 


IString 

frames 


unsigned long 

hours 


unsigned long 

hundredths 


unsigned long 

minutes 


unsigned long 

ordinal 


unsigned long 

seconds 


unsigned long 

thousandths 


unsigned long 

track 


unsigned long 

valid 


Boolean 

Actions - IMMTrackMinSecFrameTime 


Figure 222. Actions 

- IMMTrackMinSecFrameTime 


Action 

Parameters 


operator != 

IMMTime& 

time 

operator + 

IMMTime& 

time 

operator += 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator -= 

IMMTime& 

time 

operator < 

IMMTime& 

time 

operator <= 

IMMTime& 

time 

operator - 

IMMTime& 

time 

operator == 

IMMTime& 

time 

operator > 

IMMTime& 

time 

operator >= 

IMMTime& 

time 

operator unsigned long 



setTimeT oOrdinal 

unsigned long ordinal 
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Chapter 89. IPair 

Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM ordered pair of coordinates 

IPair 

IBase 

Class interface part 
vbbase.vbb 

Attributes - IPair 



Figure 223. Attributes ■ 

- IPair. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

coord1 

■ 

Coord 

coord2 

■ 

Coord 

Actions - IPair 


Figure 224. Actions - IPair 

Action 

Parameters 

distanceFrom 

IPair& aPair 

dotProduct 

IPair& aPair 

maximum 

IPair& aPair 

minimum 

IPair& aPair 

operator != 

IPair& aPair 

operator %= 

long divisor 

operator *= 

double multiplier 

operator += 

IPair& aPair 

operator - 


operator -= 

IPair& aPair 

operator /= 

double divisor 

operator < 

IPair& aPair 

operator <= 

IPair& aPair 

operator == 

IPair& aPair 

operator > 

IPair& aPair 

operator >= 

IPair& aPair 

scaleBy 

double xFactor 


double yFactor 

scaledBy 

double xFactor 


double yFactor 

transpose 



© Copyright IBM Corp. 1995 


565 



566 Visual Builder Parts Reference 



Chapter 90. IPercentAvailable 

Title: IPercentAvailable 

Class name: IPercentAvailable 

Base part: IVBase 

Part type: Class interface part 

Part file: vbbase.vbb 

Attributes - IPercentAvailable 


Figure 225. Attributes - IPercentAvailable. (S is Set) 

Attribute S 

Data type 

asDebuglnfo 

IString 

asString 

IString 

valid 

Boolean 

value ■ 

unsigned long 


Actions - IPercentAvailable 

Figure 226. Actions - IPercentAvailable 

Action 

Parameters 

operator != 

unsigned long rhs 

operator * 

unsigned long rhs 

operator *= 

unsigned long rhs 

operator + 

unsigned long rhs 

operator += 

unsigned long rhs 

operator - 

unsigned long rhs 

operator -= 

unsigned long rhs 

operator / 

unsigned long rhs 

operator /= 

unsigned long rhs 

operator < 

unsigned long rhs 

operator <= 

unsigned long rhs 

operator = 

unsigned long rhs 

IPercentAvailable& rhs 


operator == 

unsigned long rhs 

operator > 

unsigned long rhs 

operator >= 

unsigned long rhs 

operator unsigned long 
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Chapter 91. IPoint 

Title: IBM 2-dimensional mathematical point 

Class name: IPoint 

Base part: IPair 

Part type: Class interface part 

Part file: vbbase.vbb 

Attributes - IPoint 


Figure 227. Attributes - IPoint. (S is Set) 

Attribute 

s 

Data type 

asDebuglnfo 


IString 

asPOINTL 


struct _POINTL 

asString 


IString 

coord 1 

■ 

Coord 

coord2 

■ 

Coord 

X 

■ 

Coord 

y 

■ 

Coord 


Actions - IPoint 

Figure 228. Actions - IPoint 

Action 

Parameters 

distanceFrom 

IPair& aPair 

dotProduct 

IPair& aPair 

maximum 

IPair& aPair 

minimum 

IPair& aPair 

operator != 

IPair& aPair 

operator %= 

long divisor 

operator *= 

double multiplier 

operator += 

IPair& aPair 

operator - 


operator -= 

IPair& aPair 

operator /= 

double divisor 

operator < 

IPair& aPair 

operator <= 

IPair& aPair 

operator == 

IPair& aPair 

operator > 

IPair& aPair 

operator >= 

IPair& aPair 

scaleBy 

double xFactor 


double yFactor 

scaledBy 

double xFactor 


double yFactor 

transpose 
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Chapter 93. IProfile 


Title: 

IBM application-profile file 

Class name: 

IProfile 

Base part: 

IVBase 

Part type: 

Class interface part 

Part file: 

vbbase.vbb 


Attributes - IProfile 



Figure 231. Attributes - IProfile. (S is Set) 

Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

default ApplicationN ame 

■ 

IString 

handle 


IProfileHandle 

name 


IString 

numberOfApplications 


unsigned long 

numberOfKeys 


unsigned long 

systemProfile 


IProfile 

userProfile 


IProfile 

Actions - IProfile 




Figure 232. Actions - IProfile 

Action 

Parameters 

addOrRepIaceElementWithKey 

char* key 


IString& data 


char* applName=0 

containsApplication 

char* applName 

containsKeyName 

char* key 


char* applName=0 

deleteElementWithApplication 

char* applName=0 

deleteElementWithKey 

char* key 


char* applName=0 

elementWithKey 

char* key 


char* applName=0 

integerWithKey 

char* key 


char* applName=0 

operator - 

IProfile& aProfile 
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Chapter 94. IRange 

Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM range of coordinate values 

IRange 

IPair 

Class interface part 
vbbase.vbb 


Attributes - IRange 


Figure 233. Attributes - IRange. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

coord 1 

■ 

Coord 

coord2 

■ 

Coord 

lowerBound 

■ 

Coord 

upperBound 

■ 

Coord 


Actions - IRange 

Figure 234. Actions - IRange 


Action Parameters 


distanceFrom 

IPair& aPair 

dotProduct 

IPair& aPair 

includes 

Coord aValue 

maximum 

IPair& aPair 

minimum 

IPair& aPair 

operator != 

IPair& aPair 

operator %= 

long divisor 

operator *= 

double multiplier 

operator += 

IPair& aPair 

operator - 
operator -= 

IPair& aPair 

operator /= 

double divisor 

operator < 

IPair& aPair 

operator <= 

IPair& aPair 

operator == 

IPair& aPair 

operator > 

IPair& aPair 

operator >= 

IPair& aPair 

scaleBy 

double xFactor 

scaledBy 

double yFactor 
double xFactor 

transpose 

double yFactor 
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Chapter 95. IRectangle 

IBM rectangle, defined by 2 points 
IRectangle 
IBase 

Class interface part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


Attributes - IRectangle 


Figure 235. Attributes - IRectangle. (S is Set) 

Attribute 

S 

Data type 

area 


Coord 

asDebuglnfo 


IString 

asRECTL 


struct _RECTL 

asString 


IString 

bottom 


Coord 

bottomCenter 


IPoint 

bottomLeft 

■ 

IPoint 

bottomRight 


IPoint 

center 


IPoint 

eenterXCenterY 


IPoint 

eenterXMaxY 


IPoint 

eenterXMinY 


IPoint 
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Coord 

left 


Coord 

leftCenter 


IPoint 
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Coord 
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IPoint 
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IPoint 
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IPoint 

maxY 


Coord 

minX 


Coord 

minXCenterY 


IPoint 

minXMaxY 


IPoint 

minXMinY 


IPoint 

minY 


Coord 

right 


Coord 

rightCenter 


IPoint 

size 

■ 

ISize 

top 


Coord 

topCenter 


IPoint 

topLeft 


IPoint 

topRight 


IPoint 

width 


Coord 
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Figure 236. Actions - IRectangle 

Action 

Parameters 

centerAt 

IPoint& point 

centeredAt 

IPoint& point 

contains 

IPoint& point 

expandBy 

IPair& pair 

expandedBy 

Coord coord 

intersects 

IRectangle& rectangle 

moveBy 

IPair& pair 

movedBy 

IPair& pair 

movedTo 

IPoint& point 

operator != 

IRectangle& rectangle 

operator & 

IRectangle& rectangle 

operator &= 

IRectangle& rectangle 

operator == 

IRectangle& rectangle 

operator 1 

IRectangle& rectangle 

operator 1= 

IRectangle& rectangle 

scaleBy 

IPair& pair 

scaledBy 

double factor 

shrinkBy 

IPair& pair 

shrunkBy 

IPair& pair 

sizeBy 

Coord factor 

sizedBy 

double factor 

sizedTo 

IPair& pair 


578 Visual Builder Parts Reference 



Chapter 96. IResourceld 


Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM resource identifier 

IResourceld 

IBase 

Class interface part 
vbbase.vbb 

Attributes - IResourceld 

Figure 237. Attributes - 

IResourceld. (S is Set) 

Attribute 

S Data type 

asDebuglnfo 

IString 

asString 

IString 

id 

unsigned long 

resourceLibrary 

const IResourceLibrary& 

Actions - IResourceld 

Figure 238. Actions - IResourceld 

Action 

Parameters 

operator unsigned long 

operator= 

const IResourceId& 
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Chapter 97. IResourceLibrary 

Title: IBM resource file 

Class name: IResourceLibrary 

Base part: IVBase 

Part type: Class interface part 

Part file: vbbase.vbb 

Attributes - IResourceLibrary 


Figure 239. Attributes - IResourceLibrary. (S is Set) 

Attribute S 

Data type 

asDebuglnfo 

IString 

asString 

IString 

fileName 

IString 

handle 

IModuleHandle 

open 

Boolean 


Actions - IResourceLibrary 

Figure 240. Actions - IResourceLibrary 


Action 

Parameters 

loadAccelTable 

unsigned long accelTableld 

loadBitmap 

unsigned long bitmapld 

Boolean cached= true 

loadDialog 

unsigned long dialogld 

IWindow* dialogParent 

Window* dialogOwner 

IWinProc* dialogProcedure 
void* dialogCreateParameters 

loadHelpTable 

IWindow* helplnstance 
unsigned long helpTableld 

loadlcon 

unsigned long iconld 

Boolean cached= true 

loadMenu 

unsigned long menuld 

IWindow* menuOwner 

loadMessage 

unsigned long messageld 

loadPointer 

unsigned long iconld 

Boolean cached= true 

loadstring 

unsigned long stringld 

operator = 

IResourceLibrary& resLibrary 

tryT oLoadBitmap 

unsigned long bitmapld 

ISize& bitmap Size 

Boolean cached= true 

tryToLoadlcon 

unsigned long iconld 

Boolean cached= true 

tryT oLoadMessage 

unsigned long messageld 

tryToLoadString 

unsigned long stringld 
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Chapter 98. ISize 

Title: 

Class name: 
Base part: 
Part type: 
Part file: 


IBM support for size in height and width 

ISize 

IPair 

Class interface part 
vbbase.vbb 


Attributes - ISize 


Figure 241. Attributes - ISize. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asSIZEL 


SIZEL 

asString 


IString 

coord 1 

■ 

Coord 

coord2 

■ 

Coord 

height 

■ 

Coord 

width 

■ 

Coord 


Actions - ISize 


Figure 242. Actions - ISize 

Action 

Parameters 

distanceFrom 

IPair& aPair 

dotProduct 

IPair& aPair 

maximum 

IPair& aPair 

minimum 

IPair& aPair 

operator != 

IPair& aPair 

operator %= 

long divisor 

operator *= 

double multiplier 

operator += 

IPair& aPair 

operator - 


operator -= 

IPair& aPair 

operator /= 

double divisor 

operator < 

IPair& aPair 

operator <= 

IPair& aPair 

operator == 

IPair& aPair 

operator > 

IPair& aPair 

operator >= 

IPair& aPair 

scaleBy 

double xFactor 


double yFactor 

scaledBy 

double xFactor 


double yFactor 

transpose 
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Chapter 99. IString 

IBM string class, indexed starting at 1 
IString 
IBase 

Class interface part 
vbbase.vbb 


Title: 

Class name: 
Base part: 
Part type: 
Part file: 


Attributes - IString 


Figure 243. Attributes - IString. (S is Set) 

Attribute 

S 

Data type 

alphabetic 


Boolean 

alphanumeric 


Boolean 

asDebuglnfo 


IString 

asDouble 


double 

as Int 


long 

asString 


IString 

asUnsigned 


unsigned long 

binary Digits 


Boolean 

control 


Boolean 

digits 


Boolean 

graphics 


Boolean 

hexDigits 


Boolean 

includesDBCS 


Boolean 

includesMBCS 


Boolean 

includesSBCS 


Boolean 

isASCII 


Boolean 

isDBCS 


Boolean 

isLowerCase 


Boolean 

isMBCS 


Boolean 

isSBCS 


Boolean 

isUpperCase 


Boolean 

length 


unsigned 

num Words 


unsigned 

printable 


Boolean 

punctuation 


Boolean 

size 


unsigned 

validDBCS 


Boolean 

validMBCS 


Boolean 

whiteSpace 


Boolean 
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Actions - IString 

Figure 244 (Page 1 of 3). Actions - IString 

Action Parameters 


b2c 

b2d 

b2x 

c2b 

c2d 

c2x 

center 


change 


charType 
copy 

d2b 

d2c 

d2x 

includes 

indexOf 

indexOfAnyBut 

indexOfAnyOf 

indexOfPhrase 

indexOfWord 

insert 


is Abbre viationF or 
isLike 


lastlndexOf 

lastlndexOfAnyBut 

lastlndexOfAnyOf 

left Justify 

lengthOfWord 

lineFrom 


IString& aString 
IString& aString 
IString& aString 


IString& aString 
IString& aString 
unsigned length 
char padCharacter= ' 

IString& aString 
char* plnputString 
char* pOutputString 
unsigned startPos=l 

unsigned numChanges=( unsigned ) UINT_MAX 

unsigned index 

IString& aString 

unsigned numCopies 

IString& aString 


IStringTest& aTest 
char* pString 
unsigned startPos= 1 
IString& validChars 
unsigned startPos= 1 
IStringTest& aTest 
unsigned startPos= 1 
IString& wordString 
unsigned startWord— 1 
unsigned wordNumber 
IString& aString 
unsigned index =0 
char padCharacter= ' 
char* pFullString 
unsigned minAbbrevLength=0 
char* pPattern 
unsigned patternLen 
char zeroOrMore 
char anyChar 
char aCharacter 

unsigned startPos=( unsigned ) UINT_MAX 
IStringTest& aTest 

unsigned startPos=( unsigned ) UINT_MAX 
IString& searchChars 

unsigned startPos=( unsigned ) UINT_MAX 
unsigned length 
char padCharacter=' ' 
unsigned wordNumber 
istream& aStream 
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Figure 244 (Page 2 of 3). Actions - IString 

Action Parameters 


lowerCase 

occurrencesOf 


operator & 
operator &= 
operator + 
operator += 
operator - 
operator char * 
operator signed char * 
operator unsigned char 
operator [] 
operator * 
operator *= 
operator I 
operator 1= 
operator ~ 
overlay With 


remove 

remove Words 

reverse 
right Justify 

space 

strip 

stripBlanks 

stripLeading 

stripLeadingBlanks 

stripTrailing 

stripT railingBlanks 

substring 

translate 


uppercase 

word 

wordlndexOfPhrase 

words 


char delim=\ri 
IString& aString 
char* pSearchString 
unsigned searchLen 
unsigned startPos 
IString& aString 
char* pString 
IString& aString 
char* pString 
IString& aString 


unsigned index 
IString& aString 
char* pString 
IString& aString 
char* pString 

IString& aString 
IString& anOverlay 
unsigned index= 1 
char padCharacter= ' 
IString& aString 
unsigned startPos 
unsigned firstWord 
unsigned numWords 
IString& aString 
unsigned length 
char padCharacter= ' 
unsigned numSpaces= 1 
char spaceChar= ' 
IString& aString 
char aChar 
IString& aString 
IString& aString 
char* pStringOfChars 
IString& aString 
IString& aString 
IStringTest& aTest 
IString& aString 
unsigned startPos 
IString& inputChars 
IString& outputChars 
char padCharacter= ' 
IString& aString 
unsigned wordNumber 
IString& aPhrase 
unsigned startWord= 1 
unsigned firstWord 
unsigned numWords 
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Figure 244 (Page 3 of 3). Actions - IString 

Action Parameters 

x2b 
x2c 
x2d 


IString& aString 
IString& aString 
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Chapter 100. ISystemErrorlnfo 


Title: 

IBM access to system error 

information 

Class name: 

ISystemErrorlnfo 


Base part: 

IErrorlnfo 


Part type: 

Class interface part 


Part file: 

vbbase.vbb 


Attributes - ISystemErrorlnfo 


Figure 245. Attributes - 

ISystemErrorlnfo. (S is Set) 


Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

available 


Boolean 

errorld 


unsigned long 

text 


const char* 

Actions - ISystemErrorlnfo 



Figure 246. Actions - ISystemErrorlnfo 


Action 

Parameters 


operator const char * 
throwError 


throwSystemError 


IExceptionLocation& location 
IErrorlnfo: :ExceptionType name=accessError 
IException:: Severity severity=recovemb\e 
IException:: Severity severity=recovemb\e 
unsigned long systemErrorld 
char* functionName 
IExceptionLocation& location 
IErrorlnfo: :ExceptionType name=accessError 
IException::Severity severity=reco\erab\e 
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Chapter 101. ITime 

Title: 

Class name: 

Base part: 

Part type: 

Part file: 

IBM time class 

ITime 

IBase 

Class interface part 
vbbase.vbb 


Attributes - ITime 



Figure 247. Attributes ■ 

■ ITime. (S is Set) 


Attribute 

s 

Data type 

asCTIME 


_CTIME 

asDebuglnfo 


IString 

asSeconds 


long 

asString 


IString 

hours 


unsigned 

minutes 


unsigned 

now 


ITime 

seconds 


unsigned 

Actions - ITime 


Figure 248. Actions - ITime 

Action 

Parameters 

operator != 

ITime& aTime 

operator + 

ITime& aTime 

operator += 

ITime& aTime 

operator - 

ITime& aTime 

operator -= 

ITime& aTime 

operator < 

ITime& aTime 

operator <= 

ITime& aTime 

operator == 

ITime& aTime 

operator > 

ITime& aTime 

operator >= 

ITime& aTime 
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Chapter 102. ITrace 


Title: 

IBM support for module tracing 

Class name: 

ITrace 

Base part: 

IVBase 

Part type: 

Class interface part 

Part file: 

vbbase.vbb 

Attributes - ITrace 


Figure 249. Attributes - ITrace. (S is Set) 

Attribute 

s 

Data type 

asDebuglnfo 


IString 

asString 


IString 

traceDestination 


ITrace:: Destination 

traceEnabled 


Boolean 


writeLineNumberEnabled Boolean 

writePrefixEnabled Boolean 


Actions - ITrace 

Figure 250. Actions - ITrace 

Action Parameters 

disableTrace 

disableWriteLineNumber 
disable W ritePrefix 
enableTrace 

enable WriteLineNumber 
enable W ritePrefix 

write char* text 

writeToQueue 

writeToStandardError 

writeToStandardOutput 
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Part 4. Appendixes 


© Copyright IBM Corp. 1995 


595 



596 Visual Builder Parts Reference 



Appendix A. Attributes 


Figure 251 (Page 1 of 16). Attributes. (S is Set, E is Event) 

Attribute 

Class name 

S 

E 

Data type 

acquired 

IMMDevice 



Boolean 

activeColor 

IWindow 

■ 

■ 

IColor 

acti veT extB ackgroundColor 

ITitle 

■ 

■ 

IColor 

acti veT extForegroundColor 

ITitle 

■ 

■ 

IColor 

aliasName 

IMMDevice 



IString 

alignment 

IBaseSpinButton 

■ 


Alignment 


IStaticText 

■ 


Alignment 


ISetCanvas 

■ 


Alignment 


IProgressIndicator 



Alignment 


IEntryField 

■ 


Alignment 

allowsDragDelete 

IToolBarButton 



Boolean 

allowsDragDrop 

IToolBar 



Boolean 

allowsMouseClickFocus 

IButton 

■ 


Boolean 

alphabetic 

IString 



Boolean 

alphanumeric 

IString 



Boolean 

anchorBlock 

ICurrentThread 



I AnchorB lockHandle 

animatedWhenLatched 

IAnimatedB utton 



Boolean 

animationRate 

IAnimatedB utton 

■ 


unsigned long 

animationStarted 

IAnimatedB utton 



Boolean 

anyElement 

IACoIlection 



Element const& 

area 

IRectangle 



Coord 

areDetailsViewTitlesVisible 

IContainerControl 

■ 


Boolean 

areHeadphonesEnabled 

IMMMasterAudio 



Boolean 

areSpeakersEnabled 

IMMMasterAudio 



Boolean 

argc 

ICurrentApplication 



int 

armPixelOffset 

IProgressIndicator 

■ 

■ 

unsigned long 

armRange 

ICircularSlider 

■ 


IRange 


IProgressIndicator 



unsigned long 

armSize 

ISlider 

■ 


ISize 

armTickOffset 

IProgressIndicator 

■ 

■ 

unsigned long 

asCDATE 

IDate 



_CDATE 

asCTIME 

ITime 



_CTIME 

asDebuglnfo 

IBase 



IString 

asDouble 

IString 



double 

asExtendedUnsignedLong 

IBitFlag 



unsigned long 

aslnt 

IString 



long 

asMMTime 

IMMTime 



unsigned long 

asPOINTL 

IPoint 



struct _POINTL 

asRECTL 

IRectangle 



struct _RECTL 

asRGBLong 

IColor 



long 

asSeconds 

ITime 



long 

asSIZEL 

ISize 



SIZEL 

asString 

IBase 



IString 

asUnsigned 

IString 



unsigned long 


IHandle 



unsigned long 

asUnsignedLong 

IBitFlag 



unsigned long 

audioEnabled 

IMMDevice 

■ 


Boolean 
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Figure 251 (Page 2 of 16). Attributes. (S is Set, E is Event) 

Attribute 

Class name 

S 

E 

Data type 

autoDeleteObject 

IWindow 

■ 


Boolean 

autoDeleteT arget 

IVBVariableClassBase 

■ 


Boolean 

autoDestroyWindow 

IWindow 

■ 


Boolean 

autoLatchEnabled 

ICustomButton 

■ 


Boolean 

autoPlayEnabled 

IMMAudioCD 

■ 


Boolean 

autoScroll 

IEntryField 

■ 


Boolean 

autoSelect 

ICheckBox 

■ 


Boolean 


IRadioButton 

■ 


Boolean 

autoTab 

IEntryField 

■ 


Boolean 

available 

IGUIErrorlnfo 



Boolean 


IMMErrorlnfo 



Boolean 


ISystemErrorlnfo 



Boolean 


ICLibErrorlnfo 



Boolean 

averageB y tesPerS econd 

IMMAudioHeader 

■ 


unsigned long 

avgCharWidth 

IFont 



unsigned long 

avgLowercase 

IFont 



unsigned long 

avgUppercase 

IFont 



unsigned long 

backgroundColor 

IWindow 

■ 

■ 

IColor 

balance 

IMMAmpMixer 

■ 


unsigned long 

base 

IV SequenceOnBase 



Base& 

bass 

IMMAmpMixer 

■ 


unsigned long 

bidiSupported 

IWindow 



Boolean 

binaryDigits 

IString 



Boolean 

binding 

INotebook 

■ 


Binding 

bitmap 

IAnimatedButton 



IBitmapHandle 


IGraphicPushButton 

■ 


IBitmapHandle 


IToolBarButton 

■ 


IBitmapHandle 


IFont 



Boolean 


IMenuItem 

■ 


IBitmapHandle 


IClipboard 

■ 


IBitmapHandle 


IBitmapControl 

■ 


IBitmapHandle 

bitmapCount 

IAnimatedButton 



unsigned long 

bitmapOnly 

IFont 



Boolean 

bitmapSize 

IToolBarButton 



ISize 

bitmapVisible 

IToolBarButton 



Boolean 

bitsPerSample 

IMMConfigurableAudio 

■ 


unsigned long 


IMMAudioHeader 

■ 


unsigned long 


IMMAudioBuffer 

■ 


unsigned long 

blockAlign 

IMMAudioHeader 

■ 


unsigned long 

blockAlignment 

IMMConfigurableAudio 

■ 


unsigned long 


IMMAudioBuffer 

■ 


unsigned long 

blueMix 

IColor 

■ 


unsigned char 

bold 

IFont 

■ 


Boolean 

border 

IBaseSpinButton 



Boolean 


IPushButton 

■ 


Boolean 

borderColor 

IWindow 

■ 

■ 

IColor 

borderHeight 

IFrameWindow 

■ 


unsigned long 

borderS ize 

IFrameWindow 

■ 


ISize 

borderWidth 

IFrameWindow 

■ 


unsigned long 

bottom 

IRectangle 



Coord 

bottomCenter 

IRectangle 



IPoint 
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Figure 251 (Page 3 of 16). Attributes. (S is Set, E is Event) 

Attribute 

Class name 

s 

E 

Data type 

bottomLeft 

IRectangle 

■ 


IPoint 

bottomRight 

IRectangle 



IPoint 

bounded 

IRSequence 



IBoolean 

buttonPressedld 

IVBFileDialog 



long 


IFontDialog 



unsigned long 


IVBFontDialog 



unsigned long 


IFileDialog 



unsigned long 

buttonsPosition 

ISlider 



ButtonsPosition 

button View 

IToolBar 

■ 


IToolBarButton:: View 

bytesPerSecond 

IMMAudioBuffer 

■ 


unsigned long 


IMMConfigurableAudio 

■ 


unsigned long 

cachingEnabled 

IContainerControl 

■ 


Boolean 

canRedo 

IMMRecordable 



Boolean 

canUndo 

IMMRecordable 



Boolean 

center 

IRectangle 



IPoint 

centerXCenterY 

IRectangle 



IPoint 

centerXMaxY 

IRectangle 



IPoint 

centerXMinY 

IRectangle 



IPoint 

changed 

IMultiLineEdit 



Boolean 


IEntryField 



Boolean 

channels 

IMMConfigurableAudio 

■ 


unsigned long 


IMMAudioHeader 

■ 


unsigned long 


IMMAudioBuffer 

■ 


unsigned long 

characters ize 

IWindow 



ISize 

charType 

IEntryField 

■ 


CharType 

checked 

IMenuItem 

■ 


Boolean 

client 

IFrameWindow 

■ 


IWindow* 

clientHandle 

IFrameWindow 



IWindowHandle 

clipboardHasT extFormat 

ITextControl 



Boolean 

closeOnDestroy 

IMMDevice 

■ 


Boolean 

columnCount 

IContainerControl 



unsigned long 

command 

IEntryField 

■ 

■ 

Boolean 

commandType 

IMenuItem 

■ 


CommandType 

communicationWindow 

IHelpWindow 



IWindowHandle 

consistent 

IACollection 



IBoolean 

contents 

IMMAudioCD 



IMMAudioCDContents 

contents W indo w 

IHelpWindow 



IWindowHandle 

contentType 

IMMAudioBuffer 

■ 


ContentType 


IMMAudioHeader 

■ 


ContentType 

continuousPlayEnabled 

IMMAudioCD 

■ 


Boolean 

control 

IString 



Boolean 

coord 1 

IPair 

■ 


Coord 

coord2 

IPair 

■ 


Coord 

count 

IBaseListBox 



unsigned long 


IBaseComboBox 



unsigned long 

co verPage Window 

IHelpWindow 



IWindowHandle 

current 

IApplication 



ICurrentApplication& 

currentBitmapIndex 

IAnimatedButton 



unsigned long 

currentEditColumn 

IContainerControl 



IContainerColumn * 

currentEditMLE 

IContainerControl 



IMultiLineEdit* 

currentEditObj ect 

IContainerControl 



IContainerObject* 


Appendix A. Attributes 599 



Figure 251 (Page 4 of 16). Attributes. (S is Set, E is Event) 


Attribute 

Class name 

S 

E 

Data type 

currentGraphicT ype 

IGraphicPushButton 



GraphicType 

currentPID 

IApplication 



IProcessId 

cursoredObject 

IC ontainerControl 



IContainerObj ect* 

cursorLinePosition 

IMultiLineEdit 

■ 


unsigned long 

cursorPosition 

IEntryField 

■ 


unsigned long 


IMultiLineEdit 

■ 


unsigned long 

cursorSelect 

IRadioButton 

■ 


Boolean 

cutCopy B ufferS ize 

IMMW ave Audio 



unsigned long 

data 

IMMAudioBuffer 

■ 


IString 

date 

IC ontainerColumn 



Boolean 

dayOfMonth 

IDate 



int 

dayOfWeek 

IDate 



DayOfWeek 

dayOfY ear 

IDate 



int 

deckCount 

ISetCanvas 

■ 


unsigned long 

deckOrientation 

ISetCanvas 

■ 

■ 

DeckOrientation 

default 

IPushButton 

■ 


Boolean 

defaultApplicationName 

IProfile 

■ 


IString 

defaultCell 

IMultiCellCanvas 

■ 


ISize 

defaultGroupPad 

IToolBar 

■ 


unsigned long 

defaultMargin 

IToolBar 

■ 


ISize 

defaultMisfitWidth 

IToolBar 

■ 


unsigned long 

defaultOrdering 

IFrameWindow 

■ 


IWindow: :SiblingOrder 

defaultPad 

IToolBar 

■ 


long 

defaultPushButton 

IWindow 



IW indo wHandle 

defaultText 

IFlyOverHelpHandler 

■ 


IString 

defaultTransparentColor 

IToolBarButton 

■ 


IColor 

defaultTransparentColorSet 

IToolBarButton 



Boolean 

delay Time 

IFlyOverHelpHandler 

■ 


unsigned long 

description 

IMMDevice 



IString 

destinationRectangle 

IMMDigital Video 



IRectangle 

detailsTitleRectangle 

IC ontainerControl 



IRectangle 

details View 

IContainerControl 



Boolean 

detail s V iewPortOn Window 

IC ontainerControl 



IRectangle 

detail s V iewPortOn W orkspace 

IC ontainerControl 



IRectangle 

detailsViewSplit 

IC ontainerControl 

■ 


IContainerColumn* 

deviceld 

IMMDevice 



unsigned long 

deviceName 

IMMDevice 



IString 

deviceType 

IMMPlayerPanel 



unsigned long 


IMMDevice 



unsigned long 

digits 

IString 



Boolean 

disabled 

IMenuItem 

■ 


Boolean 

disabledBackgroundColor 

IWindow 

■ 

■ 

IColor 

disabledForegroundColor 

IWindow 

■ 

■ 

IColor 

disabledText 

IlnfoArea 

■ 

■ 

IString 

discld 

IMMAudioCDContents 



IString 


IMMAudioCD 



IString 

discTitle 

IMMAudioCD 

■ 


IString 

displaySize 

ITextControl 



ISize 

displayWidth 

IC ontainerColumn 

■ 


unsigned long 

dragLines 

IMultiCellCanvas 

■ 


Boolean 

drawB ackgroundEnabled 

IContainerControl 

■ 


Boolean 
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Figure 251 (Page 5 of 16). Attributes. (S is Set, E is Event) 


Attribute 

Class name 

s 

E 

Data type 

drawltem 

IMenuItem 

■ 


Boolean 


IBaseListBox 

■ 


Boolean 

drawItemEnabled 

IProgressIndicator 

■ 


Boolean 


IContainerControl 

■ 


Boolean 

dropOnAble 

IContainerObj ect 

■ 


Boolean 

editRegionHeight 

IMultiEineEdit 

■ 


unsigned long 

editRegionWidth 

IMultiLineEdit 

■ 


unsigned long 

emHeight 

IVBFontDialog 



unsigned long 


IFontDialog 



unsigned long 

empty 

INotebook 



Boolean 


IBaseListBox 



Boolean 


IACollection 



IBoolean 


IEntryField 



Boolean 

enabled 

IWindow 

■ 

■ 

Boolean 


IHandler 

■ 


Boolean 

enabledForNotification 

INotifier 

■ 


Boolean 


INotifier 

■ 


Boolean 


IRSequence 

■ 


Boolean 

errorld 

IErrorlnfo 



unsigned long 


ICLibErrorlnfo 



unsigned long 


IMMErrorlnfo 



unsigned long 


IErrorlnfo 



unsigned long 

expanded 

IToolBar 



Boolean 

extendedSelect 

IBaseListBox 

■ 


Boolean 

extendedSelection 

IContainerControl 



Boolean 

extemalLeading 

IFontDialog 



unsigned long 


IVBFontDialog 



unsigned long 


IFont 



unsigned long 

fastForwardButton 

IMMPlayerPanel 



IAnimatedButton* 

fastSpeed 

IMMDigital V ideo 



IMMSpeed 

fastSpinEnabled 

IBaseSpinButton 

■ 


Boolean 

fattrs 

IFont 



const struct _FATTRS* 

fileDialog 

IVBFileDialog 



IFileDialog* 

fileDialogSettings 

IVBFileDialog 



IFileDialog: :Settings* 

fileName 

IResourceLibrary 



IString 

filename 

IMMFileMedia 

■ 


IString 

fileName 

IVBFileDialog 

■ 

■ 

IString 


IFileDialog 



IString 

fileNormalSpeed 

IMMDigital V ideo 



IMMSpeed 

fillBackground 

IStaticText 

■ 

■ 

Boolean 

fillColor 

IStaticText 

■ 

■ 

IColor 

firstElement 

IRSequence 



Element const& 

firstPage 

INotebook 



IPageHandle 

fixed 

IFont 



Boolean 

flashing 

IFrameWindow 



Boolean 

floatingFrame 

IToolBar 



IToolB arFrame W indo w * 

floatingPosition 

IToolBar 

■ 


IPoint 

floatingTitle 

IToolBar 

■ 


IString 

flowed 

IContainerControl 



Boolean 

flo wedN ameV ie w 

IContainerControl 



Boolean 

flowedTextView 

IContainerControl 



Boolean 
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Figure 251 (Page 6 of 16). Attributes. (S is Set, E is Event) 

Attribute 

Class name 

S 

E 

Data type 

flyOverHelpHandler 

IVBFlyText 



IFlyOverHelpHandler* 

flyTextControl 

IFlyOverHelpHandler 

■ 


IFlyText* 

flyTextStringTableOffset 

IFlyOverHelpFlandler 

■ 


long 

focus 

IWindow 


■ 

Boolean 

font 

IWindow 

■ 

■ 

IFont 


IVBFontDialog 

■ 

■ 

IFont 

fontDialog 

IVBFontDialog 



IFontDialog* 

fontDialogSettings 

IVBFontDialog 



IFontDialog:: Settings* 

fontFamily 

IFontDialog 



IString 


IVBFontDialog 



IString 

fontmetrics 

IFont 



const struct _FONTMETRICS* 

font Weight 

IVBFontDialog 



unsigned long 


IFontDialog 



unsigned long 

font Width 

IFontDialog 



unsigned long 


IVBFontDialog 



unsigned long 

foregroundColor 

IWindow 

■ 

■ 

IColor 

format 

IMMAudioBuffer 

■ 


Format 


IMMConfigurableAudio 

■ 


IMMAudioBuffer: :Format 


IMMSpeed 



Format 

formatCount 

IClipboard 



unsigned long 

formatTag 

IMMAudioFIeader 

■ 


FormatTag 

framed 

IMenuItem 

■ 


Boolean 

frames 

IMMHourMinSecFrameTime 



unsigned long 


IMMMinSecFrameTime 



unsigned long 


IMMTrackMinSecFrameTime 



unsigned long 

framesPerSecond 

IMMHourMinSecFrameTime 



unsigned long 

frame Window 

IWindow 



Boolean 

full 

IRSequence 



IBoolean 

gain 

IMMAmpMixer 

■ 


unsigned long 

graphics 

IString 



Boolean 

graphic W indo w 

IGraphicPushButton 



IIconControl& 

greenMix 

IColor 

■ 


unsigned char 

gridLines 

IMultiCellCanvas 

■ 


Boolean 

group 

IWindow 



Boolean 


IControl 

■ 


Boolean 

groupPad 

ISetCanvas 

■ 


unsigned long 

gUIInitialized 

ICurrentThread 



Boolean 

halftone 

IStaticText 

■ 

■ 

Boolean 

handle 

IResourceLibrary 



IModuleHandle 


IAccelerator 



IAccelTblHandle 


IProfile 



IProfileHandle 


IMMDigital Video 



IW indo wHandle 


IWindow 



IW indo wHandle 

hasBitmap 

IClipboard 



Boolean 

hasSelectedT ext 

IEntryField 



Boolean 


IMultiLineEdit 



Boolean 

hasText 

IClipboard 



Boolean 

hasTransparentColor 

IToolBarButton 



Boolean 

headerData 

IMMAudioBuffer 



IString 


IMMAudioHeader 



const void* 

headinglcon 

IC ontainerColumn 

■ 


IPointerHandle 
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Attribute 

Class name 

s 

E 

Data type 

headinglconHandle 

IContainerColumn 



Boolean 

headingString 

IContainerColumn 



Boolean 

headingText 

IContainerColumn 

■ 


IString 

headingWriteable 

IContainerColumn 

■ 


Boolean 

height 

IRectangle 



Coord 


ISize 

■ 


Coord 

help 

IPushButton 

■ 


Boolean 

helpld 

IContainerColumn 

■ 


unsigned long 


IContainerObject 



unsigned long 

hexDigits 

IString 



Boolean 

highlighted 

IMenuItem 

■ 


Boolean 


IButton 



Boolean 

hihteB ackgroundColor 

IWindow 

■ 

■ 

IColor 

hiliteForegroundColor 

IWindow 

■ 

■ 

IColor 

homePosition 

IProgressIndicator 

■ 


HomePosition 

horizontal 

IScrollBar 



Boolean 

horizontalDataAlignment 

IContainerColumn 



HorizontalAlignment 

horizontalHeadingAlignment 

IContainerColumn 



HorizontalAlignment 

horizontalScroll 

IBaseListBox 



Boolean 


IBaseComboBox 



Boolean 

horizontalScrollBar 

I ViewPort 



IScrollBar* 

horizontalSeparator 

IContainerColumn 



Boolean 

hours 

IMMTime 



unsigned long 


ITime 



unsigned 

hundredths 

IMMTime 



unsigned long 

icon 

IlconControl 

■ 


IPointerHandle 


IContainerObj ect 

■ 


IPointerHandle 


IGraphicPu shB utton 

■ 


IPointerHandle 


IFrameWindow 

■ 


IPointerHandle 

iconHandle 

IContainerColumn 



Boolean 

iconSize 

IContainerControl 

■ 


ISize 

iconText 

IContainerObject 

■ 


IString 

iconView 

IContainerControl 



Boolean 

id 

IApplication 



IProcessId 


IResourceld 



unsigned long 


IMenuItem 



unsigned long 


IWindow 

■ 


unsigned long 

inactiveColor 

IWindow 

■ 

■ 

IColor 

inactiveText 

IlnfoArea 

■ 

■ 

IString 

inactiveTextBackgroundColor 

ITitle 

■ 

■ 

IColor 

inactiveTextForegroundColor 

ITitle 

■ 

■ 

IColor 

includesDBCS 

IString 



Boolean 

includesMBCS 

IString 



Boolean 

includesSBCS 

IString 



Boolean 

index 

IMenuItem 

■ 


unsigned long 


IColor 



long 

index Window 

IHelpWindow 



IWindowHandle 

insertMode 

IEntryField 

■ 

■ 

Boolean 

internalLeading 

IFont 



unsigned long 

inUse 

IContainerObject 

■ 


Boolean 

isASCII 

IString 



Boolean 
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Figure 251 (Page 8 of 16). Attributes. (S is Set, E is Event) 

Attribute Class name S E Data type 


isBitmap 

IMenuItem 



Boolean 

isDBCS 

IString 



Boolean 

isDigits 

ITextControl 


■ 



ITextSpinButton 


■ 


isLowerCase 

IString 



Boolean 

isMBCS 

IString 



Boolean 

isOpen 

IClipboard 



Boolean 


IMMDevice 



Boolean 

isSBCS 

IString 



Boolean 

isSet 

IAccelerator 



Boolean 

isText 

IMenuItem 



Boolean 

isUpperCase 

IString 



Boolean 

italic 

IFont 

■ 


Boolean 

itemProvider 

I Window 

■ 


IDMItemProvider* 

items 

IVB ContainerControl 

■ 

■ 

IVSequence < Element > 


ICollectionViewComboBox 

■ 

■ 

Collection* 


ICollectionViewListBox 

■ 

■ 

Collection* 

julianDate 

IDate 



unsigned long 

lastElement 

IAOrderedCollection 



Element const& 

lastPage 

INotebook 



IPageHandle 

latched 

ICustomButton 

■ 

■ 

Boolean 

latchedB ackgroundColor 

ICustomButton 

■ 


IColor 

latchedB ackgroundColorHalftone 

ICustomButton 



Boolean 

latchedB itmap 

IToolBarButton 

■ 


IBitmapHandle 

latchedForegroundColor 

ICustomButton 

■ 


IColor 

latchingEnabled 

ICustomButton 

■ 


Boolean 

lay out Adjustment 

I Window 



IRectangle 

layoutType 

IMenuItem 

■ 


LayoutType 

left 

IRectangle 



Coord 

leftCenter 

IRectangle 



IPoint 

leftlndex 

IEntryField 

■ 


unsigned long 

length 

IString 



unsigned 


IMM AudioB uffer 



unsigned long 


IMMPlayableDevice 



unsigned long 

limit 

IStaticText 

■ 

■ 

unsigned long 


IBaseSpinButton 

■ 


unsigned long 


IMultiLineEdit 

■ 

■ 

unsigned long 


IEntryField 

■ 

■ 

unsigned long 

lineCount 

IlnfoArea 

■ 


unsigned long 

lineSpacing 

IContainerControl 

■ 


long 

listShowing 

IB aseComboB ox 



Boolean 

location 

IToolBar 

■ 


Location 

longStringTableOffset 

IFlyOverHelpHandler 

■ 


long 

longT extControl 

IFlyOverHelpHandler 

■ 


ITextControl* 


I VB Fly Text 

■ 


ITextControl* 

lowerBound 

IRange 

■ 


Coord 

maj orT abB ackgroundColor 

INotebook 

■ 

■ 

IColor 

maj orT abForegroundColor 

INotebook 

■ 

■ 

IColor 

margin 

ISetCanvas 

■ 


ISize 


IEntryField 

■ 


Boolean 

marginSize 

IGraphicPushButton 

■ 


ISize 
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Attribute 

Class name 

s 

E 

Data type 

master 

IBaseSpinButton 



Boolean 

maxAscender 

IFont 



unsigned long 

maxCharHeight 

IFont 



unsigned long 

maxDescender 

IFont 



unsigned long 

maximized 

IFrameWindow 



Boolean 

maximizeRect 

IFrameWindow 



IRectangle 

maximumSpeed 

IMMDigital V ideo 



IMMSpeed 

maximumW indo w s 

IMMDigital V ideo 



unsigned long 

maxLowercase Ascender 

IFont 



unsigned long 

maxLowercaseDescender 

IFont 



unsigned long 

maxNumberOfElements 

IRSequence 



INumber 

maxSize 

IFont 



ISize 

maxUppercaseSize 

IFont 



ISize 

maxX 

IRectangle 



Coord 

maxXCenterY 

IRectangle 



IPoint 

maxXMaxY 

IRectangle 



IPoint 

maxXMinY 

IRectangle 



IPoint 

maxY 

IRectangle 



Coord 

mediaPresent 

IMMRemovableMedia 



Boolean 

mediaType 

IMMAudioBuffer 

■ 


unsigned long 

menu 





menuHandle 

IMenu 



IMenuHandle 

messageQueue 

IWindow 



IMessageQueueHandle 

minimized 

IFrameWindow 



Boolean 

minimizeRect 

IFrameWindow 



IRectangle 

minimumCharacters 

IBaseListBox 

■ 


unsigned long 

minimumRows 

IBaseComboBox 

■ 


unsigned long 


IBaseListBox 

■ 


unsigned long 

minimumSize 

IWindow 

■ 


ISize 

minimumSpeed 

IMMDigital V ideo 



IMMSpeed 

minorT abB ackgroundColor 

INotebook 

■ 

■ 

IColor 

minorT abForegroundColor 

INotebook 

■ 

■ 

IColor 

minScrollIncrement 

IScrollBar 

■ 


unsigned long 

minutes 

IMMTime 



unsigned long 


ITime 



unsigned 

minX 

IRectangle 



Coord 

minXCenterY 

IRectangle 



IPoint 

minXMaxY 

IRectangle 



IPoint 

minXMinY 

IRectangle 



IPoint 

minY 

IRectangle 



Coord 

misfitFilteringEnabled 

IToolBar 

■ 


Boolean 

missingText 

IlnfoArea 

■ 

■ 

IString 

mixedT argetEmphasi s 

IContainerControl 



Boolean 

modal 

IFrameWindow 



Boolean 

mode 

IMMDevice 



Mode 

modeless 

IFileDialog 



Boolean 


IVBFontDialog 



Boolean 


IFontDialog 



Boolean 


IVBFileDialog 



Boolean 

monitorHandle 

IMMDigital V ideo 



IWindowHandle 
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Attribute 

Class name 

s 

E 

Data type 

monitoringEnabled 

IMMAmpMixer 

■ 


Boolean 


IMMDigital V ideo 

■ 


Boolean 

monthOfYear 

IDate 



Month 

mousePointer 

IFrame Window 

■ 


IPointerHandle 

multipleSelect 

IBaseListBox 

■ 


Boolean 

multipleSelection 

IContainerControl 



Boolean 

name 

IProfile 



IString 


IFont 

■ 


IString 

name View 

IContainerControl 



Boolean 

nativeRect 

I Window 



IRectangle 

newCursor 

IRSequence 



ICursor* 

nextShellRect 

IFrame Window 



IRectangle 

noAdjustPosition 

IBaseListBox 

■ 


Boolean 

noDismiss 

IMenuItem 

■ 


Boolean 

nominalPointSize 

IFontDialog 



unsigned long 


IVBFontDialog 



unsigned long 

nonPropOnly 

IFont 



Boolean 

normalSpeed 

IMMDigital V ideo 



IMMSpeed 

normalTargetEmphasis 

IContainerControl 



Boolean 

notebook 

IVBNotebookPage 



const IWindow* 

now 

ITime 



ITime 

number 

IContainerColumn 



Boolean 

numberOfApplications 

IProfile 



unsigned long 

numberOfColumnChanges 

IContainerControl 



unsigned long 

numberOfElements 

IRSequence 



INumber 

numberOfEntries 

IMMAudioCDContents 



unsigned long 

numberOfltems 

IMenu 



unsigned long 

numberOfKeys 

IProfile 



unsigned long 

numberOfLines 

IMultiLineEdit 



unsigned long 

numberOfObj ectChanges 

IContainerControl 



unsigned long 

numberOfSelections 

IBaseListBox 



unsigned long 


IBaseComboBox 



unsigned long 


IVB ContainerControl 



unsigned long 

numberOfTracks 

IMMAudioCDContents 



unsigned long 


IMMAudioCD 



unsigned long 

num Words 

IString 



unsigned 

objectCopy 

IContainerObject 



IContainerObj ect 5 

objectCount 

IContainerControl 



unsigned long 

objectList 

IContainerControl 



ICnrObjectSet 

objectText 

ITitle 

■ 

■ 

IString 

open 

IContainerObject 

■ 


Boolean 


IResourceLibrary 



Boolean 

orderedTargetEmphasis 

IContainerControl 



Boolean 

ordinal 

IMMTime 



unsigned long 

orientation 

INotebook 

■ 

■ 

Orientation 


ISplitCanvas 

■ 

■ 

Orientation 

origDefaultB uttonHandle 

ICanvas 



IW indo wHandle 

outline 

IFont 

■ 


Boolean 

outlineType 

IOutlineBox 

■ 


OutlineType 

owner 

I Window 

■ 


IWindow* 


IClipboard 



IW indo wHandle 
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Attribute 

Class name 

S 

E 

Data type 


IAccelerator 



IWindow* 

packType 

ISetCanvas 

■ 


PackType 

pad 

ISetCanvas 

■ 


ISize 

pageB ackgroundColor 

INotebook 

■ 

■ 

IColor 

pageHandle 

IVBNotebookPage 



IPageHandle 

pageScrollIncrement 

IScrollBar 

■ 


unsigned long 

pageSize 

INotebook 



ISize 

parent 

IWindow 

■ 


IWindow* 

parentSize 

IWindow 



ISize 

pauseButton 

IMMPlayerPanel 



IAnimatedButton* 

pitch 

IMMAmpMixer 

■ 


unsigned long 

playableDevice 

IMMPlayerPanel 

■ 


IMMPlayableDevice* 

play Button 

IMMPlayerPanel 



IAnimatedButton* 

playingForward 

IMMDigitalVideo 



Boolean 

pointerCaptured 

IWindow 



Boolean 

pointSize 

IVBFontDialog 

■ 


unsigned long 


IFont 

■ 


unsigned long 


IFontDialog 



unsigned long 

position 

IMMPlayableDevice 



unsigned long 


IWindow 

■ 

■ 

IPoint 

prerollTime 

IMMDevice 



IMMTime 

prerollType 

IMMDevice 



PrerollType 

pressedOK 

IFileDialog 



Boolean 


IVBFileDialog 



Boolean 


IFontDialog 



Boolean 


IVBFontDialog 



Boolean 

presSpace 

IWindow 



IPresSpaceHandle 

primaryFormat 

IClipboard 



IString 

primaryScale 

IProgressIndicator 

■ 

■ 

Scale 

printable 

IString 



Boolean 

profile 

IMMAudioCD 

■ 


IProfile 

punctuation 

IString 



Boolean 

radius 

ICircularSlider 



unsigned long 

range 

INumericSpinButton 

■ 


IRange 

readonly 

IEntryField 



Boolean 


IMMFileMedia 



Boolean 

rect 

IWindow 

■ 


IRectangle 

redMix 

IColor 

■ 


unsigned char 

refreshOn 

IContainerControl 

■ 


Boolean 


IContainerObject 

■ 


Boolean 

relativeWindowRect 

IFlyText 

■ 


IRectangle 

remainingStack 

ICurrentThread 



unsigned long 

requiresFiles 

IMMDevice 



Boolean 

resourceLibrary 

ICurrentApplication 

■ 


IResourceLibrary& 


IResourceld 



const IResourceLibrary& 


IFlyOverHelpHandler 

■ 


IResourceLibrary& 


IlnfoArea 

■ 

■ 

IResourceLibrary& 

restoreRect 

IFrame Window 

■ 


IRectangle 

result 

IFrame Window 

■ 

■ 

unsigned long 

return Value 

IVBFileDialog 



long 


IFileDialog 



long 
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Attribute 

Class name 

s 

E 

Data type 


IFontDialog 



long 


IVBFontDialog 



long 

reversed 

IPointArray 



IPointArray 

rewindButton 

IMMPlayerPanel 



IAnimatedButton* 

ribbonStripEnabled 

IProgressIndicator 

■ 


Boolean 

right 

IRectangle 



Coord 

rightCenter 

IRectangle 



IPoint 

rotationlncrement 

ICircularSlider 

■ 


unsigned long 

samplesPerSecond 

IMMConfigurableAudio 

■ 


unsigned long 


IMMAudioHeader 

■ 


unsigned long 


IMMAudioBuffer 

■ 


unsigned long 

saveAsEAType 

IFileDialog 



IString 


IVBFileDialog 



IString 

scrollableRange 

IScrollBar 

■ 


IRange 

scrollB oxPosition 

IScrollBar 

■ 

■ 

unsigned long 

scrollBoxRange 

IScrollBar 



IRange 

searchListWindow 

IHelpWindow 



IW indo wHandle 

seconds 

IMMTime 



unsigned long 


ITime 



unsigned 

selectable 

IMenuItem 

■ 


Boolean 

selected 

ISettingButton 

■ 


Boolean 

selectedCnrObj ects 

IVB ContainerControl 



IVSequence < CnrElement * >* 

selectedCollectionPosition 

ICollectionViewComboBox 



unsigned long 


ICollectionViewListBox 



unsigned long 

selectedElement 

ICollectionViewComboBox 



Element 


ICollectionViewListBox 



Element 

selectedFileCount 

IFileDialog 



unsigned 


IVBFileDialog 



unsigned long 

selectedlndex 

IRadioButton 



unsigned long 

selectedObjects 

I VB ContainerControl 



IVSequence < Element >* 

selectedRange 

IMultiLineEdit 



IRange 


IEntryField 



IRange 

selectedText 

IMultiLineEdit 



IString 


IEntryField 



IString 

selectedT extLength 

IMultiLineEdit 



unsigned long 


IEntryField 



unsigned long 

selection 

IB aseComboB ox 



long 


IBaseListBox 



long 

selectionlndices 

I VB ContainerControl 

■ 


IVSequence < unsigned long >* 

selectionls Valid 

I VB ContainerControl 



Boolean 

separator 

IMenuItem 



Boolean 

servant 

IBaseSpinButton 



Boolean 

shadowColor 

I Window 

■ 

■ 

IColor 

shaftPosition 

IProgressIndicator 

■ 


IPoint 

shafts ize 

IProgressIndicator 



ISize 

showing 

I Window 



Boolean 

showingMinilcons 

IContainerControl 



Boolean 

singleSelection 

IContainerControl 



Boolean 

size 

IRectangle 

■ 


ISize 


IPointArray 



unsigned long 


I Window 

■ 

■ 

ISize 
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Attribute 

Class name 

S 

E 

Data type 


IString 



unsigned 

sizeToGraphic 

IGraphicPushButton 

■ 


Boolean 

slowSpeed 

IMMDigitalVideo 



IMMSpeed 

snapToTickEnabled 

IProgressIndicator 

■ 


Boolean 

sourceRectangle 

IMMDigitalVideo 



IRectangle 

speed 

IMMSpeed 



unsigned long 


IMMDigitalVideo 



IMMSpeed 

speedFormat 

IMMDevice 

■ 


IMMSpeed: :Format 

spinFieldValid 

IBaseSpinButton 



Boolean 


IBaseSpinButton 



Boolean 

splitB arEdgeColor 

ISplitCanvas 

■ 


IColor 

splitB arMiddleColor 

ISplitCanvas 

■ 


IColor 

splitB arOffset 

IContainerControl 



unsigned long 

standardB itmapS ize 

IToolBarB utton 

■ 


ISize 

standardFormat 

IToolBarB utton 



Boolean 

standardTextLines 

IToolBarB utton 

■ 


unsigned long 

s tandardT ext Wi dth 

IToolBarB utton 

■ 


unsigned long 

statusText 

IVBNotebookPage 

■ 


IString 

statusTextAlignment 

INotebook 

■ 


TextAlignment 

stepB ackw ardB utton 

IMMPlayerPanel 



IAnimatedButton* 

stepForwardButton 

IMMPlayerPanel 



IAnimatedButton* 

stopButton 

IMMPlayerPanel 



IAnimatedButton* 

strikeout 

IFont 

■ 


Boolean 


IStaticText 

■ 

■ 

Boolean 

string 

IContainerColumn 



Boolean 

stringGenerator 

ICollection Vie wC omboB ox 

■ 


IStringGenerator < Element >& 


ICollectionViewListBox 

■ 


IStringGenerator < Element >& 

stringTableOffset 

IlnfoArea 

■ 


long 

submenu 

IMenuItem 



Boolean 

submenuHandle 

IMenuItem 

■ 


IWindowHandle 

subscriptOffset 

IFont 



ISize 

subscriptSize 

IFont 



ISize 

superscriptOffset 

IFont 



ISize 

superscripts ize 

IFont 



ISize 

supportsAudio 

IMMDevice 



Boolean 

supportsDigitalT ransfer 

IMMDevice 



Boolean 

supportsDisableEject 

IMMDevice 



Boolean 

supportsEject 

IMMDevice 



Boolean 

supportsOverlayGraphics 

IMMDigitalVideo 



Boolean 

supportsPlay 

IMMDevice 



Boolean 

supportsRecord 

IMMDevice 



Boolean 

supportsRecordlnsertion 

IMMDevice 



Boolean 

supportsReverse 

IMMDigitalVideo 



Boolean 

supportsSave 

IMMDevice 



Boolean 

supportsSizing 

IMMDigitalVideo 



Boolean 

supportsStreaming 

IMMDevice 



Boolean 

supportsStretchToFit 

IMMDigitalVideo 



Boolean 

supports Video 

IMMDevice 



Boolean 

supports Volume Adjustment 

IMMDevice 



Boolean 

systemCommand 

IPushButton 

■ 

■ 

Boolean 

systemProfile 

IProfile 



IProfile 
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Figure 251 (Page 14 of 16). Attributes. (S is Set, E is Event) 

Attribute 

Class name 

S 

E 

Data type 

systemScrollBarWidth 

IScrollBar 



unsigned long 

systemScrollBoxLength 

IScrollBar 



unsigned long 

systemScrollButtonLength 

IScrollBar 



unsigned long 

tabBitmap 

IVBNotebookPage 

■ 


IBitmapHandle 

tabShape 

INotebook 

■ 


TabShape 

tabStop 

IControl 

■ 


Boolean 


IWindow 



Boolean 

tabText 

IVBNotebookPage 

■ 


IString 

tabText Alignment 

INotebook 

■ 


TextAlignment 

targetPtr 

IVBVariableClass 



Element* 


IVBVariableClassPointer 



Element 


IVBVariablePart 



Element* 


IVB V ariablePartPointer 



Element 

text 

ISetCanvas 

■ 

■ 

IString 


ITextSpinButton 

■ 

■ 

IString 


IMMErrorlnfo 



const char* 


ICLibErrorlnfo 



const char* 


IMenuItem 

■ 


IString 


ISystemErrorlnfo 



const char* 


IGUIErrorlnfo 



const char* 


IClipboard 

■ 


IString 


ITextControl 

■ 

■ 

IString 

textLength 

ITextControl 


■ 

unsigned long 


ITextSpinButton 


■ 


text View 

IC ontainerControl 



Boolean 

text Visible 

IToolBarButton 



Boolean 

this 

IVBVariableClassPointer 

■ 

■ 

Element 


IVBVariablePart 

■ 

■ 

Element 


I VB V ariablePartPointer 

■ 

■ 

Element 


IVBVariableClass 

■ 

■ 

Element 

thousandths 

IMMTime 



unsigned long 

tickSpacing 

ICircularSlider 

■ 


unsigned long 

time 

IC ontainerColumn 



Boolean 

timeFormat 

IMMDevice 

■ 


IMMTime:: Format 

title 

IC ontainerControl 

■ 

■ 

IString 

titleRectangle 

IC ontainerControl 



IRectangle 

titleSeparatorVisible 

IC ontainerControl 

■ 


Boolean 

titleVisible 

IC ontainerControl 

■ 

■ 

Boolean 

titleWriteable 

IC ontainerControl 

■ 


Boolean 

today 

IDate 



IDate 

toolB arContainer 

IToolBar 



IToolB arContainer* 

toolBarList 

IFrameWindow 

■ 


IToolBarList* 

top 

IBaseComboBox 

■ 


unsigned long 


IMultiLineEdit 

■ 


unsigned long 


IRectangle 



Coord 


IBaseListBox 

■ 


unsigned long 

topCenter 

IRectangle 



IPoint 

topLeft 

IRectangle 



IPoint 

topPage 

INotebook 



IPageHandle 

topRight 

IRectangle 



IPoint 

totalPages 

INotebook 



unsigned long 
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Figure 251 (Page 15 of 16). Attributes. (S is Set, E is Event) 

Attribute 

Class name 

S 

E 

Data type 

traceDestination 

ITrace 



ITrace: :Destination 

traceEnabled 

ITrace 



Boolean 

track 

IMMTrackMinSecFrameTime 



unsigned long 

transparentColor 

IToolBarButton 

■ 


IColor 

treble 

IMMAmpMixer 

■ 


unsigned long 

treelconView 

IContainerControl 



Boolean 

treeNameView 

IContainerControl 



Boolean 

treeTextView 

IContainerControl 



Boolean 

tree View 

IContainerControl 



Boolean 

type 

IBaseComboBox 



ControlType 

underscore 

IFont 

■ 


Boolean 


IStaticText 

■ 

■ 

Boolean 

undoable 

IMultiLineEdit 



Boolean 

upc 

IMMAudioCD 



IString 


IMMCDXA 



IString 

upperBound 

IRange 

■ 


Coord 

useCount 

IRefCounted 



unsigned 

userData 

ICustomButton 

■ 


unsigned long 

userProfile 

IProfile 



IProfile 

userResourceLibrary 

ICurrentApplication 

■ 


IResourceLibrary& 

usesDialogBackground 

IFrame Window 



Boolean 

valid 

IMMAudioCDContents 



Boolean 


IMMTime 



Boolean 


IPercentAvailable 



Boolean 


IWindow 



Boolean 

validDBCS 

IString 



Boolean 

validMBCS 

IString 



Boolean 

value 

IColor 



Color 


INumericSpinButton 

■ 

■ 

long 


IPercentAvailable 

■ 


unsigned long 


ICircularSlider 

■ 

■ 

long 

valueAsDouble 

ITextSpinButton 

■ 

■ 



ITextControl 

■ 

■ 


valueAsInt 

ITextControl 

■ 

■ 



ITextSpinButton 

■ 

■ 


valueAsUnsigned 

ITextControl 

■ 

■ 



ITextSpinButton 

■ 

■ 


vectorOnly 

IFont 



Boolean 

vertical 

IProgressIndicator 



Boolean 


IScrollBar 



Boolean 

verticalDataAlignment 

IContainerColumn 



V ertical Alignment 

verticalHeadingAlignment 

IContainerColumn 



V ertical Alignment 

verticals crollB ar 

IViewPort 



IScrollBar* 

verticalSeparator 

IContainerColumn 



Boolean 

videoFileHeight 

IMMDigitalVideo 



unsigned long 

videoFileName 

IMMDigitalVideo 



IString 

videoFileWidth 

IMMDigitalVideo 



unsigned long 

videoHeight 

IMMDigitalVideo 



unsigned long 

video Width 

IMMDigitalVideo 



unsigned long 

view 

IToolBarButton 

■ 


View 

viewedPages W indo w 

IHelpWindow 



IWindowHandle 
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Figure 251 (Page 16 of 16). Attributes. (S is Set, E is Event) 


Attribute 

Class name 

s 

E 

Data type 

viewNum 

ITitle 

■ 


unsigned long 

viewNumber 

ITitle 

■ 

■ 

unsigned long 

viewPortOnWindow 

IContainerControl 



IRectangle 

vie wPortOn W orkspace 

IContainerControl 



IRectangle 

viewText 

ITitle 

■ 

■ 

IString 

viewWindow 

I ViewPort 



IW indo wHandle 

view Windo wDrawRectangle 

I ViewPort 



IRectangle 

viewWindowSize 

I ViewPort 

■ 

■ 

ISize 

visible 

IContainerObject 

■ 


Boolean 


IContainerColumn 

■ 


Boolean 


I Window 

■ 

■ 

Boolean 

visibleCount 

IScrollBar 

■ 


unsigned long 

visibleLines 

IMultiLineEdit 



unsigned long 

visibleRectangle 

I Window 



IRectangle 

volume 

IMMMasterAudio 

■ 


unsigned long 


IMMDevice 

■ 


unsigned long 

waitForAny Thread 

ICurrentThread 



IThreadld 

whiteSpace 

IString 



Boolean 

width 

ISize 

■ 


Coord 


IRectangle 



Coord 

willDeleteColumnsOnClose 

IContainerControl 



Boolean 

willDeleteObjectsOnClose 

IContainerControl 



Boolean 

willDestroyOnClose 

IFrame Window 



Boolean 

window 

IVB N otebookPage 

■ 


I Window* 

wordwrap 

IMultiLineEdit 

■ 


Boolean 

writeable 

IContainerObject 

■ 


Boolean 


IEntryField 

■ 

■ 

Boolean 


IContainerColumn 

■ 


Boolean 


IBaseSpinButton 

■ 


Boolean 


IMultiLineEdit 

■ 

■ 

Boolean 

writeLineNumberEnabled 

ITrace 



Boolean 

writePrefixEnabled 

ITrace 



Boolean 

X 

IPoint 

■ 


Coord 

xHeight 

IVBFontDialog 



unsigned long 


IFontDialog 



unsigned long 

y 

IPoint 

■ 


Coord 

year 

IDate 



int 
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Appendix B. Actions 


Figure 252 (Page 1 of 26). Actions 


Action 

Class name 

Parameters 

acquire 

IMMDevice 

ShareMode acquire=IMMDevice:: shareable 
Boolean queuedForResources=fa\s& 

CallType ca//=IMMDevice::wait 

add 

IMultiLineEdit 

char* text 

unsigned long textSize=0 

EOLFormat Zy/?e=IMultiLineEdit: :cfText 


IComboBox 

unsigned long index 
char * const* itemList 
unsigned long count= 1 


IPointArray 

IPoint& point 


IListBox 

unsigned long index 
char * const* itemList 
unsigned long count= 1 


ITextSpinButton 

IResourceId& item 
unsigned long index 


IRSequence 

Element const& 

ICursor& 

addAllFrom 

IACollection 

IACollection < Element > const& 

addAscending 

IComboBox 

char* text 


IListBox 

char* text 

addAsFirst 

IListBox 

char* text 


IToolBar 

IWindow* window 

Boolean startNewGroup=fa\se 


IRSequence 

Element const& 


IComboBox 

char* text 


ITextSpinButton 

IResourceId& item 

addAsLast 

IMultiLineEdit 

char* text 

unsigned long textSize=0 

EOLFormat Jype=IMultiLineEdit: :cfText 


IListBox 

IResourceId& item 


IASequentialCollection 

Element const& 

ICursor& 


IToolBar 

IWindow* window 

Boolean startNewGroup=fa\se 


ITextSpinButton 

IResourceId& item 


IComboBox 

IResourceId& item 

addAsNext 

IToolBar 

IWindow* window 

IWindow* referenceWindow 

Boolean startNewGroup= false 

addAsPrevious 

IToolBar 

IWindow* window 

IWindow* referenceWindow 

Boolean startNewGroup=fa\se 

addAtOffset 

IMultiLineEdit 

char* text 

unsigned long charnumber 
unsigned long textSize=0 

EOLFormat Zy/?e=IMultiLineEdit: :cfText 

addAtPosition 

IASequentialCollection 

IPosition 
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Figure 252 (Page 2 of 26). Actions 


Action 

Class name 

Parameters 

addBitmap 

IMenu 

Element const& 
unsigned long newltemld 

addB order 

IBaseSpinButton 

unsigned long bitmapResId 
unsigned long intoSubmenuld- 0 

Boolean add= true 

addColumn 

IContainerControl 

IContainerColumn* column 

addCuePoint 

IMMPlayableDevice 

IContainerColumn* afterColumn- 0 

IMMTime& time 

addDescending 

IListBox 

CallType c«//=IMMDevice::wait 
char* text 


IComboBox 

char* text 

addDetent 

ISlider 

unsigned long offset 

addDrive 

IVBFileDialog 

char* drive 

addEntryAsFirst 

IMMAudioCDContents 

unsigned long trackNumber 

addExtension 

IFrame Window 

IWindow* newExtension 

addFileType 

IVBFileDialog 

Location location 

SeparatorType 

se/?< 2 raror=IFrameWindow: :thinLine 
char* fileType 

addFirstPage 

INotebook 

PageSettings& pagelnfo 

addltem 

IMenu 

IWindow* pageWindow=0 

IMenuItem& menultem 


IVBContainerControl 

unsigned long intoSubmenuId= 0 
unsigned long position 

addFastPage 

INotebook 

PageSettings& pagelnfo 

addFibraries 

IHelpWindow 

IWindow* pageWindow- 0 
char* he Ip Library Names 

addFine 

IMultiFineEdit 

char* text 

addFineAsFast 

IMultiFineEdit 

unsigned long lineNumber 

EOLFormat ly/?e=IMultiLineEdit: xfText 
char* text 

addObject 

IContainerControl 

EOLFormat ly/?e=IMultiLineEdit: xfText 
IContainerObject* newObject 

addObject After 

IContainerControl 

IContainerObject* parentObject=0 
IContainerObject* newObject 

addObjects 

IContainerControl 

IContainerObject* afterObject 

IContainerObject* parentObject=0 

ICnrAllocator& allocator 

addObj ects After 

IContainerControl 

IContainerObject* parentObject=0 

ICnrAllocator& allocator 

addOrReplaceElementWithKey 

IProfile 

IContainerObject* pcnrobjAfter 

IContainerObject* parentObject=0 
char* key 

addPageAfter 

INotebook 

IString& data 
char* applName=0 

PageSettings& pagelnfo 

addPageBefore 

INotebook 

Cursor& cursor 

IWindow* pageWindow- 0 

PageSettings& pagelnfo 



Cursor& cursor 

IWindow* pageWindow=0 
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Figure 252 (Page 3 of 26). Actions 

Action Class name Parameters 

addRef IRefCounted 


addSeparator 

IMenu 

unsigned long intoSubmenuId= 0 

addSubmenu 

IMenu 

unsigned long itemld 

addText 

IMenu 

unsigned long newltemld 

IResourceId& textResId 
unsigned long intoSubmenuId= 0 

addToCell 

IMultiCellCanvas 

IWindow* childWindow 
unsigned long startingColumn 
unsigned long startingRow 
unsigned long number OfColumns=\ 
unsigned long numberOfRows= 1 

addT o W indo wList 

IFrame Window 


adjustPriority 

IApplication 

long adjustment 

Boolean setDescendents=fa\se 

allElementsDo 

IRSequence 

IBoolean ( * function ) ( Element& 
void * ) , void* additional Argument^ 0 

applyBidiSettings 

IWindow 

BidiSettings& settings 

Boolean childInherit=lmQ 

Boolean refresh—Xxwo, 

argv 

ICurrentApplication 

int argument^umber 

arrangelcon V iew 

IContainerControl 


b2c 

IString 

IString& aString 

b2d 

IString 

IString& aString 

b2x 

IString 

IString& aString 

beginFlashing 

IFrame Window 


beginUsingFont 

IFont 

IPresSpaceHandle& presSpaceHandle 

c2b 

IString 


c2d 

IString 


c2x 

IString 

IString& aString 

capturePointer 

IWindow 

Boolean capture= true 

center 

IString 

IString& aString 
unsigned length 
char padCharacter= ' 

centerAt 

IRectangle 

IPoint& point 

centeredAt 

IRectangle 

IPoint& point 

change 

IString 

IString& aString 
char* plnputString 
char* pOutputString 
unsigned startPos= 1 

unsigned numChanges={ unsigned ) UINT_MAX 


IOString 

IString& aString 

IString& inputString 

IString& outputstring 
unsigned startPos= 0 

unsigned numChanges={ unsigned ) UINT_MAX 

charType 

IString 

unsigned index 

charWidth 

IFont 

char c 

checkltem 

IMenu 

unsigned long itemld 

Boolean check= true 

clear 

IMultiLineEdit 

unsigned long timestamp- 0 


IEntryField 

unsigned long timestamp- 0 
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Figure 252 (Page 4 of 26). Actions 


Action 

Class name 

Parameters 

clearDefaultTransparentColor 

IToolBarButton 


click 

IButton 


clientRectFor 

IFrame Window 

IRectangle& frameRect 

close 

IFrame Window 

IClipboard 

IDynamicLinkLibrary 



IMMDevice 

CallType ca//=IMMDe vice:: wait 

closeDoor 

IMMRemovableMedia 

CallType c«//=IMMDevice::wait 

closeEdit 

IContainerControl 


collapse 

IContainerControl 

IToolBar 

IContainerObject* object 

collapseTree 

IContainerControl 


collectionReplaced 

ICollectionViewComboBox 

ICollectionViewListBox 


columnAt 

IContainerControl 

unsigned long index 

columnUnderPoint 

IContainerControl 

IPoint& point 

column Width 

IMultiCellCanvas 

unsigned long column 

compare 

IASequence 

IASequence < Element > const& 

long ( * comparisonFunction ) ( Element const & 

, Element const & ) 

connectedDeviceld 

IMMDevice 

ConnectorType type 

CallType c«//=IMMDevice::wait 

containerFromHandle 

IContainerControl 

IWindowHandle& handle 

contains 

IRectangle 

IPoint& point 

containsApplication 

IProfile 

char* applName 

containsKeyName 

IProfile 

char* key 
char* applName=0 

containsObject 

IContainerControl 

IContainerObject* object 

convertToGUIStyle 

IMenuItem 

IBitFlag& style 

Boolean extendedOnly= false 


I Window 

IBitFlag& style 

Boolean extendedOnly= false 

con vertT o W orkspace 

IContainerControl 

IRectangle& windowRectangle 

Boolean rightWindow= false 

copy 

IMMRecordable 

IMMTime&/rara=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType call= IMMDevice::wait 


IACollection 

IACollection < Element > const& 


IMultiLineEdit 

unsigned long timestamp- 0 


IEntryField 

unsigned long timestamp- 0 


IString 

IString& aString 
unsigned numCopies 

copyFromB uffer 

IMM W ave Audio 

IMMAudioBuffer& audio Buffer 

CallType call= IMMDevice: :wait 

copyObjectTo 

IContainerControl 

IContainerObject* copy Object 

IContainerObject* parentObject=0 
IContainerControl* newContainer= 0 
IContainerObject* after Objects 

IPoint& iconViewLocation= IPoint (0,0) 

copyToB uffer 

IMM W ave Audio 

IMMAudioBuffer& audioBujfer 

IMMTime& /rora=IMMTime ( ) 
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Figure 252 (Page 5 of 26). Actions 


Action 

Class name 

Parameters 

cueForPlayback 

IMMPlayableDevice 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 

CallType ca//=IMMDevice::wait 

cueForRecording 

IMMRecordable 

CallType ca//=IMMDevice::nowait 

cursor 

IMenu 

unsigned long itemld 

cut 

IMultiLineEdit 

unsigned long inSubmenuId= 0 
unsigned long timestamp- 0 


IEntryField 

unsigned long timestamp- 0 


IMMRecordable 

IMMTime& /row=IMMTime ( ) 

cutToBuffer 

IMM W ave Audio 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 
IMMAudioBuffer& audioBuffer 

d2b 

IString 

IMMTime& /row=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 

IString& aString 

d2c 

IString 


d2x 

IString 


data 

IClipboard 

char* format 

dataAsDate 

IContainerColumn 

IContainerObject* object 

dataAsIcon 

IContainerColumn 

IContainerObject* object 

dataAsNumber 

IContainerColumn 

IContainerObject* object 

dataAsString 

IContainerColumn 

IContainerObject* object 

dataAsTime 

IContainerColumn 

IContainerObject* object 

dayName 

IDate 

DayOfWeek aDay 

daysInMonth 

IDate 

Month aMonth 

day sin Year 

IDate 

int aYear 

int aYear 

delete AllObjects 

IContainerControl 


deleteElementWith Application 

IProfile 

char* applName= 0 

deleteElementW ithKey 

IProfile 

char* key 

deleteltem 

IVB ContainerControl 

char* applName=0 
unsigned long position 


IMenu 

unsigned long itemld 

deletePendingEvents 

IMMDevice 

EventType £V£wr=IMMDevice:: allEvents 

deleteSelectedObjects 

IContainerControl 


deleteSelection 

IMMRecordable 

IMMTime& /rora=IMMTime ( ) 

deleteTarget 

IVBVariableClassPointer 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 

descendentsOf 

IContainerControl 

IContainerObject* parentObject 

deselect 

IBaseComboBox 

unsigned long index 


IBaseListBox 

unsigned long index 

deselectAll 

ISettingButton 

I VB ContainerControl 


detailsObjectRectangle 

IBaseListBox 

IBaseComboBox 

IContainerControl 

IContainerObject* object 

detentPosition 

ISlider 

Boolean rightWindow= false 
unsigned long detentld 

disable 

IHandler 
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Figure 252 (Page 6 of 26). Actions 

Action 

Class name 

Parameters 


IWindow 


disableAnimateWhenLatched 

IAnimatedButton 


disableAudio 

IMMDevice 

AudioChannel channel^ IMMDevice::all 

IMMMillisecondTime& 
0 ver=IMMMillisecondTime ( ) 

CallType call= IMMDevice::wait 

disableAutoLatch 

ICustomButton 


disableAutoPlay 

IMMAudioCD 


disableAutoScroll 

IEntryField 


disableAutoSelect 

ICheckBox 

IRadioButton 


disableAutoTab 

IEntryField 


disableCaching 

IC ontainerControl 


disableCommand 

IEntryField 


disableConnector 

IMMDevice 

ConnectorType type 

CallType call= IMMDevice::wait 

disableContinuousPlay 

IMMAudioCD 


disableCursorSelect 

IRadioButton 


disableDataUpdate 

IBaseSpinButton 

IC ontainerObj ect 

IEntryField 

IMultiLineEdit 

IContainerControl* containers 0 


IC ontainerControl 

IC ontainerColumn 

IContainerObject* object 

disableDefault 

IPushButton 


disableDragDelete 

IToolBarButton 


disableDragDrop 

IToolBar 


disableDragLines 

IMultiCellCanvas 


di sableDrawB ackground 

IC ontainerControl 


disableDrawItem 

IBaseListBox 

IProgressIndicator 

IC ontainerControl 


disableDrop 

IC ontainerControl 

IContainerObject* object 


IC ontainerObj ect 

IContainerControl* containers 0 

disableExtendedSelect 

IBaseListBox 


disableFastSpin 

IBaseSpinButton 


disableFillBackground 

IStaticText 


disableGridLines 

IMultiCellCanvas 


disableGroup 

IControl 


disableHalftone 

IStaticText 


disableHeadingUpdate 

IC ontainerColumn 


disableHeadphones 

IMMMasterAudio 

IMMDevice::CallType ca//=IMMDevice::wait 

disableHelp 

IPushButton 


disablelnsertMode 

IEntryField 


disableltem 

IMenu 

unsigned long itemld 

disableLatching 

ICustomButton 


disableMargin 

IEntryField 


disableMisfitFiltering 

IToolBar 


disableMonitoring 

IMMDigitalVideo 

CallType call= IMMDevice::wait 


IMMAmpMixer 

CallType call= IMMDevice::wait 

disableMouseClickFocus 

IButton 
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Figure 252 (Page 7 of 26). Actions 

Action Class name Parameters 


disableMultipleSelect 

IBaseListBox 


disableNoAdjustPosition 

IBaseListBox 


disableNotification 

IRSequence 

IWindow 

IStandardNotifier 


disableRibbonStrip 

IProgressIndicator 


disableSizeToGraphic 

IGraphicPushButton 


disableSnapToTick 

IProgressIndicator 


disableSpeakers 

IMMMasterAudio 

IMMDevice: :CallType ca//=IMMDevice:: wait 

disableStrikeout 

IStaticText 


disableSystemCommand 

IPushButton 


disableTabStop 

IControl 


disableTitleUpdate 

IContainerControl 


disableTrace 

ITrace 


disableUnderscore 

IStaticText 


disableUpdate 

IWindow 


disableWordWrap 

IMultiLineEdit 


disableWriteLineNumber 

ITrace 


disableWritePrefix 

ITrace 


discard 

IMultiLineEdit 

IEntryField 


dismiss 

IFrameWindow 

unsigned long result =0 

dispatchRemainingHandlers 

IWindow 

IEvent& event 

Boolean callDefProc =true 

distanceFrom 

IPair 

IPair& aPair 

dotProduct 

IPair 

IPair& aPair 

editColumnTitle 

IContainerControl 

IContainerColumn* column 

editContainerTitle 

IContainerControl 


editObject 

IContainerControl 

IContainerObject* object 

IContainerColumn* column =0 

elementAdded 

ICollectionViewListBox 

unsigned long position 

Element& element 


ICollectionViewComboBox 

unsigned long position 

Element& element 

elementAt 

ITextSpinButton 

unsigned long index 

elementAtPosition 

IRSequence 

IPosition 

elementChanged 

ICollectionViewListBox 

unsigned long position 

Element& element 


ICollectionViewComboBox 

unsigned long position 

Element& element 

elementDeleted 

ICollectionViewListBox 

unsigned long position 


ICollectionViewComboBox 

unsigned long position 

elementsChanged 

ICollection V iewComboB ox 

ICollectionViewListBox 


elementW ithKey 

IProfile 

char* key 
char* applName=0 

empty 

IClipboard 


enable 

IWindow 

Boolean enabled =true 

enableAnimateWhenLatched 

I AnimatedB utton 

Boolean enable=truQ 

enableConnector 

IMMDevice 

ConnectorType type 

Boolean enable =true 


Appendix B. Actions 


619 



Figure 252 (Page 8 of 26). Actions 


Action 

Class name 

Parameters 

enableDataUpdate 

IContainerControl 

CallType c«//=IMMDevice::wait 
IContainerObject* object 

enableDragDelete 

IToolBarButton 

Boolean enable= true 

Boolean enable= true 

enableDragDrop 

IToolBar 

Boolean enable= true 

enableDrop 

IContainerControl 

IContainerObject* object 

enableHeadphones 

IMMMasterAudio 

Boolean enable= true 

Boolean enable= true 

enableltem 

IMenu 

IMMDevice: :CallType c«//=IMMDevice::wait 
unsigned long itemld 

enableSpeakers 

IMMMasterAudio 

Boolean enable= true 

Boolean enable= true 

enableTrace 

ITrace 

IMMDevice: :CallType c«//=IMMDevice::wait 

enableUpdate 

IWindow 

Boolean enableWindow=tmQ 

enable WriteLineNumber 

ITrace 


enableWritePrefix 

ITrace 


endFlashing 

IFrame Window 


endUsingFont 

IFont 

IPresSpaceHandle& presSpaceHandle 

exit 

ICurrentThread 

unsigned long returnCode 

expand 

ICurrentApplication 

IToolBar 

Boolean expand= true 


IContainerControl 

IContainerObject* object 

expandBy 

IRectangle 

IPair& pair 

expandedBy 

IRectangle 

Coord coord 

expandTree 

IContainerControl 


exportSelectedTextToFile 

IMultiLineEdit 

char* fileName 

exportToFile 

IMultiLineEdit 

EOLFormat fy/?e=IMultiLineEdit: :cfText 
char* fileName 

filter 

IContainerControl 

EOLFormat fy/?e=IMultiLineEdit: :cfText 

flyHelpText 

IFlyOverHelpHandler 

IWindowHandle& handle 

format 

IClipboard 

Cursor& cursor 

formatAsHandle 

IClipboard 

char* format 

frameRectFor 

IFrameWindow 

IRectangle& clientRect 

goToEntry 

IMMAudioCD 

unsigned long index 

handleCursoredChange 

IContainerObject 

IContainerControl* container 

handleException 

IWindow 

Boolean acquired 

IException& dispatcherException 

handleFor 

IFrameWindow 

IEvent& exceptionEvent 

Style& standardControl 

handlelnuseChange 

IContainerObject 

IContainerControl* container 

handleNotificationsFor 

IObserver 

Boolean acquired 

INotifier& notifier 

handleOpen 

IContainerObject 

IEventData& userData=IEventDa.ta ( ) 
IContainerControl* container 

handleSelectedChange 

IContainerObject 

IContainerControl* container 

handleTreeCollapse 

IContainerObject 

Boolean acquired 

IContainerControl* container 

handleTreeExpand 

IContainerObject 

IContainerControl* container 

hasData 

IClipboard 

char* format 
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Figure 252 (Page 9 of 26). Actions 


Action Class name Parameters 


IWindow* window 


helpWindow 

IHelp Window 

hide 

IContainerColumn 

IWindow 

IContainerObject 

hideDetailsViewTitles 

IContainerControl 

hideList 

IBaseComboBox 

hideObject 

IContainerControl 

hidePanellds 

IHelpWindow 

hideSeparators 

IContainerColumn 

hideSourceEmphasis 

IWindow 

hideSplitBar 

IContainerControl 

hideTitle 

IContainerControl 

hideT itleS eparator 

IContainerControl 

hideTreeLine 

IContainerControl 

highlight 

IButton 

iconRectangle 

IContainerControl 

immediateDescendentsOf 

IContainerControl 

importFromFile 

IMultiLineEdit 

includes 

IString 

IRange 

indexOf 

IString 

indexOfAnyBut 

IString 

indexOfAnyOf 

IString 

indexOfPhrase 

IString 

indexOfW ord 

IString 

initialize 

IContainerControl 

initializeGUI 

ICurrentThread 

insert 

IOString 



IPointArray 


IString 

integerWithKey 

IProfile 

intersects 

isAbbreviationFor 

IRectangle 

IString 

isAnExtension 

isCollapsed 

isColumnExpandable 

IFrameWindow 

IContainerControl 

IMultiCellCanvas 


IContainerControl* container^ 0 


IContainerObject* object 

DataStyle& separatorStyles= horizontalSeparator I 
verticalSeparator 


Boolean highlight= true 
IContainerObject* object 
Boolean includeText= false 
IContainerObject* parentObject 
char* fileName 

EOLFormat Jype=IMultiLineEdit: :cfText 

IStringTest& aTest 

Coord aValue 

char* pString 

unsigned startPos= 1 

IString& validChars 

unsigned startPos= 1 

IStringTest& aTest 

unsigned startPos= 1 

IString& wordString 

unsigned startWord= 1 

unsigned wordNumber 

long queueSize=3 0 
IString& aString 
IString& anlnsert 

unsigned index={ unsigned ) UINT_MAX 

char padCharacter= ' 

unsigned long index 

IPoint& point 

IString& aString 

unsigned index= 0 

char padCharacter= ' 

char* key 

char* applName=0 

IRectangle& rectangle 

char* pFullString 

unsigned minAbbrevLength=0 

I Window* window 

IContainerObject* object 

unsigned long column 
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Figure 252 (Page 10 of 26). Actions 


Action 

Class name 

Parameters 

isColumnRight 

IContainerControl 

IContainerColumn* column 

isConnectionSupported 

IMMDevice 

ConnectorType type 

CallType c«//=IMMDevice::wait 

isConnectorEnabled 

IMMDevice 

ConnectorType type 

CallType c«//=IMMDevice::wait 

isCursored 

IContainerControl 

IContainerObject* object 

isDropOnAble 

IContainerControl 

IContainerObject* object 

isEntry Point3 2B it 

IDynamicLinkLibrary 

unsigned long procedureOrdinal 

isExpanded 

IContainerControl 

IContainerObject* object 

isInUse 

IContainerControl 

IContainerObject* object 

isItemChecked 

IMenu 

unsigned long itemld 

isItemEnabled 

IMenu 

unsigned long itemld 

isLayoutDistorted 

I Window 

unsigned long lay out Attribute 

isLeapYear 

IDate 

int aYear 

isLike 

IString 

char* pPattern 
unsigned patternLen 
char zcroOrMore 
char any Char 

isMoveValid 

IContainerControl 

IContainerObject* moveObject 

IContainerObject* newParentObject=0 
IContainerControl* newContainer= 0 
IContainerObject* afterObject= 0 

isRowExpandable 

IMultiCellCanvas 

unsigned long row 

isSelected 

IContainerControl 

IContainerObject* object 


IBaseListBox 

unsigned long index 


IB aseComboB ox 

unsigned long index 

isSource 

IContainerControl 

IContainerObject* object 

isTarget 

IContainerControl 

IContainerObject* object 

is Valid 

IDate 

int aDay 

Month aMonth 

int aYear 

isWriteable 

IContainerControl 

IContainerObject* object 

itemHandle 

IB aseComboB ox 

unsigned long index 


IBaseListBox 

unsigned long index 

itemRect 

IMenu 

unsigned long itemld 

itemText 

IBaseListBox 

unsigned long index 


IB aseComboB ox 

unsigned long index 

justifyData 

IContainerColumn 

V ertical Alignment 

=IContainerColumn:: centered V ertically 
HorizontalAlignment 
=IContainerColumn:: centered 

justifyHeading 

IContainerColumn 

V ertical Alignment 

=IContainerColumn:: centered V ertically 
HorizontalAlignment 
=IContainerColumn:: centered 

lastlndexOf 

IString 

char aCharacter 

unsigned startPos={ unsigned ) UINT_MAX 

lastlndexOfAny B ut 

IString 

IStringTest& aTest 

unsigned startPos=( unsigned ) UINT_MAX 

lastlndexOfAnyOf 

IString 

IString& searchChars 


unsigned startPos=( unsigned ) UINT_MAX 
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Figure 252 (Page 11 of 26). Actions 


Action 

Class name 

Parameters 

leftJustify 

IString 

unsigned length 
char padCharacter= ' 

lengthOfWord 

IString 

unsigned wordNumber 

lineFrom 

IString 

istream& aStream 

char delim='\ri 

loadAccelTable 

IResourceLibrary 

unsigned long accelTableld 

loadBitmap 

IResourceLibrary 

unsigned long bitmapld 

Boolean cached=true 

loadDialog 

IResourceLibrary 

unsigned long dialogld 

IWindow* dialogParent 

IWindow* dialogOwner 

IWinProc* dialog Procedure 
void* dialogCreateParameters 

loadHelpTable 

IResourceLibrary 

IWindow* helplnstance 
unsigned long helpTableld 

loadlcon 

IResourceLibrary 

unsigned long iconld 

Boolean cached=true 

loadMenu 

IResourceLibrary 

unsigned long menuld 

IWindow* menuOwner 

loadMessage 

IResourceLibrary 

unsigned long messageld 

loadOnThread 

IMMFileMedia 

IString& filename 

Boolean readOnly= false 

loadPointer 

IResourceLibrary 

unsigned long iconld 

Boolean cached= true 

loadString 

IResourceLibrary 

unsigned long stringld 

locateText 

IBaseListBox 

char* searchString 

Boolean caseSensitive=tme 

SearchType search=exactMatch 
unsigned long index= first 


IBaseComboBox 

char* searchString 

Boolean caseSensitive=tme 

SearchType search=ex actMatch 
unsigned long index= first 

lock 

IResource 

long timeOut=- 1 

lockDoor 

IMMRemovableMedia 

Boolean lock= true 

CallType ca//=IMMDevice::wait 

longHelpText 

IFlyOverHelpHandler 

IWindowHandle& handle 

lowerCase 

IString 

IString& aString 

matchForMnemonic 

IWindow 

unsigned short character 

maximize 

IFrameWindow 


maximum 

IPair 

IPair& aPair 

menultem 

IMenu 

unsigned long itemld 

minimize 

IFrameWindow 


minimum 

IPair 

IPair& aPair 

minTextWidth 

IFont 

char* line 

monthName 

IDate 

Month aMonth 

moveAfter 

IToolBar 

IWindow* window 

IWindow* referenceWindow 

Boolean startNewGroup= false 

moveBefore 

IToolBar 

IWindow* window 

IWindow* referenceWindow 
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Figure 252 (Page 12 of 26). Actions 

Action 

Class name 

Parameters 



Boolean startNewGroup=fa\se 

moveBy 

IRectangle 

IPair& pair 

movedBy 

IRectangle 

IPair& pair 

movedTo 

IRectangle 

IPoint& point 

movelconTo 

IContainerControl 

IContainerObject* object 

IPoint& point 

moveObjectTo 

IContainerControl 

IContainerObject* moveObject 

IContainerObject* newParentObject=0 
IContainerControl* newContainer= 0 
IContainerObject* afterObject=0 

IPoint& iconViewLocation- IPoint (0,0) 

moveS izeT oClient 

IFrame Window 

IRectangle& clientRect 

moveToFirst 

IToolBar 

IWindow* window 

Boolean startNewGroup=fa\se 

moveToLast 

IToolBar 

IWindow* window 

Boolean startNewGroup= false 

new 

IVBFactory 


nextPage 

INotebook 

IPageHandle& referencePage 

nlsCompare 

IContainerControl 

char* textl 

char* text2 

notebooks ize 

INotebook 

IPageHandle& page 

notifyObservers 

I Window 

INotificationEvent& event 


IS tandardN otifier 

INotificationId& nld 

notifyOwner 

IFrame Window 

unsigned long id 

ICommandEvent:: Source 

sc>Mrc£=ICommandEvent: :unknown 

Boolean pointerDevice= false 

numberOfTicks 

IProgressIndicator 

Scale scale 

object At 

IContainerControl 

unsigned long index 

objectUnderPoint 

IContainerControl 

IPoint& point 

occurrencesOf 

IString 

char* pSearchString 
unsigned searchLen 
unsigned startPos 

open 

IMMDevice 

IString& fileOrDevice= IString ( ) 

Boolean shareable=tmz 

CallType c«//=IMMDevice::wait 


IClipboard 

IDynamicLinkLibrary 


openDoor 

IMMRemovableMedia 

Boolean open= true 

CallType call= IMMDevice::wait 

openOnThread 

IMMDevice 

IString& fileOrDevice=lS\nng ( ) 

Boolean shareable= true 

CallType c«//=IMMDevice::wait 

operator != 

IPercentAvailable 

unsigned long rhs 


IColor 

IColor& color 


IPair 

IPair& aPair 


IDate 

IDate& aDate 


IMMTime 

IMMTime& time 


IBitFlag 

IBitFlag& rhs 


IPointArray 

IPointArray & point Array 


IRectangle 

IRectangle& rectangle 
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Action 

Class name 

Parameters 


ITime 

ITime& aTime 

operator %= 

IPair 

long divisor 

operator & 

IRectangle 

IRectangle& rectangle 


IString 

IString& aString 

operator &= 

IString 

char* pString 


IRectangle 

IRectangle& rectangle 

operator * 

IPercentAvailable 

unsigned long rhs 

operator *= 

IPair 

double multiplier 


IPercentAvailable 

unsigned long rhs 

operator + 

ITime 

ITime& aTime 


IMMTime 

IMMTime& time 


IPercentAvailable 

unsigned long rhs 


IString 

IString& aString 


IDate 

int numDays 

operator += 

IMMTime 

IMMTime& time 


IPair 

IPair& aPair 


ITime 

ITime& aTime 


IString 

char* pString 


IPercentAvailable 

unsigned long rhs 


IDate 

int numDays 

operator - 

IDate 

IDate& aDate 


IMMTime 

IMMTime& time 


ITime 

IPair 

ITime& aTime 


IPercentAvailable 

unsigned long rhs 

operator -= 

IPair 

IPair& aPair 


ITime 

ITime& aTime 


IPercentAvailable 

unsigned long rhs 


IDate 

int numDays 


IMMTime 

IMMTime& time 

operator / 

IPercentAvailable 

unsigned long rhs 

operator /= 

IPair 

double divisor 


IPercentAvailable 

unsigned long rhs 

operator < 

IDate 

IDate& aDate 


IPercentAvailable 

unsigned long rhs 


IMMTime 

IMMTime& time 


ITime 

ITime& aTime 


IPair 

IPair& aPair 

operator <= 

IDate 

IDate& aDate 


ITime 

ITime& aTime 


IPair 

IPair& aPair 


IMMTime 

IMMTime& time 


IPercentAvailable 

unsigned long rhs 

operator = 

IProfile 

IProfile& aProfile 


IV SequenceOnBase 

IVSequenceOnBase < Element 

Base > const& c 


IMMTime 

IMMTime& time 


IColor 

IColor& color 


IFont 

IFont& rhs 


IResourceLibrary 

IResourceLibrary& resLibrary 


IPercentAvailable 

unsigned long rhs 
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Action 

Class name 

Parameters 

IPercentAvailable& rhs 

IString 

IString& aString 


IPointArray 

IPoint Array & point Array 


IMMAudioHeader 

IMMAudioHeader& audHead 


IMMAudioCDContents 

IMMAudioCDContents& newContents 


IMMAudioBuffer 

IMMAudioBuffer& audioBuffer 


IS tandardN otifier 

IStandardNotifier& aStandardNotif ier 

operator == 

IPointArray 

IPointArray & point Array 


IPercentAvailable 

unsigned long rhs 


ITime 

ITime& aTime 


IContainerObject 

IContainerObject& object 


IContainerControl 

IContainerControl& container 


IBitFlag 

IBitFlag& rhs 


IDate 

IDate& aDate 


IRectangle 

IRectangle& rectangle 


IPair 

IPair& aPair 


IColor 

IColor& color 


IMMTime 

IMMTime& time 

operator > 

IPair 

IPair& aPair 


ITime 

ITime& aTime 


IPercentAvailable 

unsigned long rhs 


IMMTime 

IMMTime& time 


IDate 

IDate& aDate 

operator >= 

IMMTime 

IMMTime& time 


ITime 

ITime& aTime 


IPair 

IPair& aPair 


IPercentAvailable 

unsigned long rhs 


IDate 

IDate& aDate 

operator char * 

.owner.name.fixSymbols 


operator const char * 

.owner.name.fixSymbols 


operator delete 

.owner.name.fixSymbols 

.owner.name.fixSymbols 

.owner.name.fixSymbols 

IContainerObject 

void * 

operator new 

.owner.name.fixSymbols 

const char* fileName 
size_t lineNumber 

operator signed char * 

.owner.name.fixSymbols 


operator unsigned char * 

.owner.name.fixSymbols 


operator unsigned long 

.owner.name.fixSymbols 


operator Value 

.owner.name.fixSymbols 

.owner.name.fixSymbols 

.owner.name.fixSymbols 


operator [] 

IString 

unsigned index 


IPointArray 

unsigned long index 

operator ^ 

IString 

IString& aString 

operator 

IString 

char* pString 

operator 1 

IString 

IString& aString 


IRectangle 

IRectangle& rectangle 

operator 1= 

IString 

char* pString 


IRectangle 

IRectangle& rectangle 
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Action 

Class name 

Parameters 

operator ~ 

IString 


operator= 

IResourceld 

const IResourceId& 

overlayWith 

IOString 

IString& aString 
char* pOverlay 
unsigned index= 0 
char padCharacter= ' 


IString 

IString& aString 

IString& anOverlay 
unsigned index= 1 
char padCharacter= ' 

pageSettings 

INotebook 

Cursor& cursor 

pagesToEnd 

INotebook 

Cursor& cursor 

pagesToMajorTab 

INotebook 

Cursor& cursor 

pagesT oMinorT ab 

INotebook 

Cursor& cursor 

parentObject 

IContainerControl 

IContainerObject* childObject 

paste 

IEntryField 



IMMRecordable 

IMultiLineEdit 

IMMTime&/rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

Boolean convert= true 

CallType ca//=IMMDevice::wait 

pasteFromBuffer 

IMMWaveAudio 

IMMAudioBuffer& audioBuffer 

IMMTime& from= IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::wait 

pasteToBuffer 

IMMWaveAudio 

IMMAudioBuffer& audioBuffer 

CallType ctf//=IMMDevice::wait 

pause 

IMMPlayableDevice 

CallType ca//=IMMDevice::wait 

play 

IMMPlayableDevice 

IMMTime& from= IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

Boolean resumelfPaused- true 

CallType ca//=IMMDevice::nowait 

play At 

IMMDigitalVideo 

IMMSpeed& speed 

IMMTime&/rom=IMMTime ( ) 

IMMTime& to=IMMTime ( ) 

CallType ca//=IMMDevice::nowait 

playFast 

IMMDigitalVideo 

IMMTime&/rora=IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::nowait 

playScan 

IMMDigitalVideo 

IMMTime& from= IMMTime ( ) 

IMMTime& fo=IMMTime ( ) 

CallType ca//=IMMDevice::nowait 

playSlow 

IMMDigitalVideo 

IMMTime&/ram=IMMTime ( ) 

IMMTime& to=IMMTime () 

CallType ca//=IMMDevice::nowait 

positionBehindSibling 

IWindow 

IWindowHandle& siblingWindow 

positionBehindSiblings 

IWindow 


positionOnSiblings 

IWindow 


postEvent 

IWindow 

unsigned long eventld 

IEventParameterl& parml=0 

IEventParameter2& parm2= 0 
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Action 

Class name 

Parameters 

previousPage 

INotebook 

IPageHandle& referencePage 

procAddress 

IDynamicLinkLibrary 

char* procedureName 

processMsgs 

ICurrentThread 


record 

IMMRecordable 

Boolean inserts true 

IMMTime& begin= IMMTime ( ) 

IMMTime& en<i=IMMTime ( ) 

Boolean resumeIfPaused=tme 

CallType c«//=IMMDevice::nowait 

redo 

IMMRecordable 

CallType c«//=IMMDevice::wait 

refresh 

I Window 

IRectangle& invalidRectangle 


IMMDigital V ideo 

IRectangle& source= IRectangle ( ) 

IRectangle& destination^ IRectangle ( ) 

CallType call= IMMDevice::wait 


IContainerObject 

IContainerControl* containers 0 

refreshAllContainers 

IContainerControl 


refreshFromList 

IVBContainerControl 


refreshTabs 

INotebook 


registerFormat 

IClipboard 

char* private Format 

release 

IMMDevice 

CallType c«//=IMMDevice::wait 

releasePointer 

I Window 


releasePresSpace 

I Window 

IPresSpaceHandle& presentationSpaceHandle 

remove 

IString 

IString& aString 
unsigned startPos 


IToolBar 

IWindow* window 


IListBox 

unsigned long index 


IPointArray 

IAccelerator 

unsigned long index 


IComboBox 

unsigned long index 


IOString 

IString& aString 
unsigned startPos 
unsigned numChars 

removeAll 

IACollection 

IEntryField 

ITextSpinButton 

IListBox 

IMultiLineEdit 

IBoolean ( * property ) ( Element const& 
void * ) , void* additionalArgument=0 

removeAllObjects 

IContainerControl 


removeAllPages 

INotebook 


removeAtPosition 

IRSequence 

IPosition 

removeB order 

IPushButton 

IBaseSpinButton 


removeColumn 

IContainerControl 

IContainerColumn* column 

removeConditionalCascade 

IMenu 

unsigned long itemWithSubmenuId 

removeCuePoint 

IMMPlayableDevice 

IMMTime& time 

CallType call= IMMDevice::wait 

removeDetent 

ISlider 

unsigned long detentld 

removeExtension 

IFrame Window 

IWindow* extension 

Boolean updateDisplay= true 

removeFirst 

IRSequence 


removeFromCell 

IMultiCellCanvas 

unsigned long column 
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Action Class name Parameters 


removeFromWindowList 

IFrameWindow 

remo veHelpT ext 

IFlyOverHelpHandler 

removelnUse 

IContainerObject 


IContainerControl 

removeLast 

IRSequence 

removeLine 

IMultiLineEdit 

removeObject 

IContainerControl 

removePage 

INotebook 

removeRef 

IRefCounted 

removeS elected 

IContainerControl 

remo veS electedObj ects 

IContainerControl 

remo veS ubmenu 

IMenu 

removeTabSection 

INotebook 

remove Words 

IString 

reset 

IAccelerator 

resetActiveColor 

IWindow 

reset ActiveTextBackgroundColor 

ITitle 

resetActiveTextForegroundColor 

ITitle 

resetBackgroundColor 

IWindow 

resetBorderColor 

IWindow 

resetChangedFlag 

IMultiLineEdit 

resetDisabledBackgroundColor 

IWindow 

resetDisabledForegroundColor 

IWindow 

resetFillColor 

IStaticText 

resetFont 

IWindow 

resetForegroundColor 

IWindow 

resetHiliteB ackgroundColor 

IWindow 

resetHiliteForegroundColor 

IWindow 

resetlnactiveColor 

IWindow 

resetlnactiveTextBackgroundColor 

ITitle 

resetlnactiveTextForegroundColor 

ITitle 

resetLatchedB ackgroundColor 

ICustomButton 

resetLatchedForegroundColor 

ICustomButton 

resetMajorTabB ackgroundColor 

INotebook 

resetMajorTabForegroundColor 

INotebook 

resetMinimumSize 

IWindow 

resetMinorT abB ackgroundColor 

INotebook 

resetMinorTabForegroundColor 

INotebook 

resetPageB ackgroundColor 

INotebook 

resetShadowColor 

IWindow 

resetSplitB arEdgeColor 

ISplitCanvas 

resetSplitB arMiddleColor 

ISplitCanvas 

resetTransparentColor 

IToolBarButton 

resize 

IPointArray 

restore 

IFrame W indow 

resume 

IMMPlayableDevice 

reverse 

IString 


unsigned long row 

IWindowHandle& handle 
IContainerControl* container= 0 
IContainerObject* object 

unsigned long lineNumber 
IContainerObject* object 
Boolean allContainers=fa\sQ 
IPageHandle& page 

IContainerObject* object 

unsigned long itemWithSubmenuId 
IPageHandle& page 
unsigned firstWord 
unsigned numWords 


unsigned long newsize 

Boolean resume= true 
CallType ca//=IMMDevice::wait 
IString& aString 
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Action 

Class name 

Parameters 

rightJustify 

IPointArray 

IString 

unsigned length 

rowHeight 

IMultiCellCanvas 

char padCharacter=' ' 
unsigned long row 

run 

ICurrentApplication 


save 

IMMRecordable 

CallType c«//=IMMDevice::nowait 

saveAs 

IMMRecordable 

IString& filename 

saveHeadphonesSetting 

IMMMasterAudio 

CallType c«//=IMMDevice::nowait 

IMMDevice: :CallType az//=IMMDevice::wait 

saveSpeakersSetting 

IMMMasterAudio 

IMMDevice: :CallType c«//=IMMDevice::wait 

save Volume 

IMMMasterAudio 

IMMDevice: :CallType oz//=IMMDevice::wait 

scaleBy 

IPair 

double xFactor 


IRectangle 

double yFactor 

IPair& pair 

scaledBy 

IPair 

double xFactor 


IRectangle 

double yFactor 
double factor 

scroll 

IContainerControl 

long vericalPixels 

scrollDetailsHorizontally 

IContainerControl 

long horizontalPixels 

Boolean rightSide=fa\se 
long horizontalPixels 

scrollHorizontally 

IContainerControl 

Boolean rightSide= false 
long pixels 

scrollToObject 

IContainerControl 

Boolean rightSide= false 

IContainerObject* object 

scroll Vertically 

IContainerControl 

long pixels 

scroll ViewHorizontallyTo 

I ViewPort 

unsigned long leftOjfset 

scroll V iew V erticallyT o 

I ViewPort 

unsigned long topOjfset 

seek 

IMMPlayableDevice 

IMMTime& to 

seekToEnd 

IMMPlayableDevice 

CallType call= IMMDevice::wait 

CallType call= IMMDevice::wait 

seekToStart 

IMMPlayableDevice 

CallType call= IMMDevice::wait 

select 

IBaseListBox 

unsigned long index 


IB aseComboB ox 

Boolean select= true 
unsigned long index 

selectAll 

IBaseListBox 

Boolean select= true 

selectedElements 

IVBContainerControl 

ICollectionViewListBox 

Collection& elements 

selectltem 

IMenu 

unsigned long itemld 

selectRange 

IMultiLineEdit 

constIRange&range =IRange(0,end) 


IEntryField 

unsigned long timestamp- 0 

const IRange &range =IRange(0,end) 

sendEvent 

I Window 

unsigned long timestamp=0 
unsigned long eventld 

set 

IAccelerator 

IEventParameterl& parml=0 

IEventParameter2& parm2= 0 

IAccelTblHandle& haccel 

set Active W indo w 

IHelpWindow 

IFrameWindow* activeWindow 

setAllEmphasis 

IFont 

IFrameWindow* relativeWindow= 0 

Boolean turnOn= true 
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Action 

Class name 

Parameters 

setArgs 

ICurrentApplication 

int argc 

char * const argv 

setAssociatedWindow 

IHelpWindow 

IFrameWindow* associatedWindow 

setBitmap 

IMenu 

unsigned long menultemld 
unsigned long newBitmapResId 

setBitmaps 

I AnimatedB utton 

IResourceId& firstBitmap 
unsigned long count 

setChangedFlag 

IMultiLineEdit 

Boolean changed= true 


IEntryField 

Boolean changeFlag= true 

setCharHeight 

IFont 

unsigned long height 

IPresSpaceHandle& 

presSpaceHandle= IPresSpaceHandle ( ) 

setCharSize 

IFont 

ISize& size 

IPresSpaceHandle& 

presSpaceHandle=lPresSpace,Hand\Q ( ) 

setCharWidth 

IFont 

unsigned long width 

IPresSpaceHandle& 

presSpaceHandle=l PresSpaceHandle ( ) 

setClosed 

IContainerObject 


setColumnWidth 

IMultiCellCanvas 

unsigned long column 
unsigned long widthlnPixels 

Boolean expandable= false 

setConditionalCascade 

IMenu 

unsigned long itemWithSubmenuId 
unsigned long defaultltemld 

setCursor 

IContainerControl 

IContainerObject* object 

setData 

IClipboard 

char* format 
void* data 

unsigned long dataLength 

setDataOffset 

IContainerColumn 

unsigned long dataOffset 

setDecrementBitmaps 

ICircularSlider 

IBitmapHandle& leftUp 

IBitmapHandle& leftDown 

setDeleteColumnsOnClose 

IContainerControl 

Boolean destroy=t rue 

setDeleteObjectsOnClose 

IContainerControl 

Boolean destroy=t rue 

setDestination 

IMMDigital V ideo 

IRectangle& rectangle 

CallType =IMMDevice::wait 

setDestroyOnClose 

IFrameWindow 

Boolean destroy=tme 

setDialogTemplate 

IVBFileDialog 

IResourceId& resourceld 


IVBFontDialog 

IResourceId& templateld 

setDirection 

IFont 

Direction direction 

setDisplayPS 

IVBFontDialog 

IPresSpaceHandle& presSpaceHandle 

setEditColumn 

IContainerControl 

IContainerColumn* column 

setEditMLE 

IContainerControl 

IMultiLineEdit* edit Fie Id 

setEditObject 

IContainerControl 

IContainerObject* object 

setEditRegion 

IMultiLineEdit 


setExtendedSelection 

IContainerControl 


setExtensionSize 

IFrameWindow 

IWindow* extension 
double widthOrHeight 

setFamily 

IVBFontDialog 

char* fontFamily 

setFocus 

IWindow 


setFontAngle 

IFont 

IPoint& point 
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Action 

Class name 

Parameters 

setFontFromFontModally 

IVBFontDialog 

IPresSpaceHandle& 

presSpaceHandle= IPresSpaceHandle ( ) 

IFont* target 

setFontFrom W indo wModally 

IVBFontDialog 

IWindow* parent=NUhL 

IFontDialog: :Style 

5ty/^=IFontDialog:: defaultstyle ( ) 

IHandler* handler= 0 

IWindow* target 

setFontShear 

IFont 

IWindow* parent=NUhL 

IFontDialog: :Style 
s*y/e=IFontDialog::defaultstyle ( ) 

IHandler* handler= 0 

IPoint& point 

setHandle 

IClipboard 

IPresSpaceHandle& 

presSpaceHandle=IPresSpaceHand\e ( ) 
const char* format 

setHelpTable 

IHelpWindow 

unsigned long handle 

IResourceId& helpTable 

setHelpText 

IFlyOverHelpHandler 

IWindowHandle& handle 

setlncrementBitmaps 

ICircularSlider 

IString& flyText 

IString& longText= IString ( ) 

IResourceId& rightUp 

setlnitialDrive 

IVBFileDialog 

IResourceId& rightDown 
char* drive 

setlnitialFileT ype 

IVBFileDialog 

char* fileType 

setlnUse 

IContainerControl 

IContainerObject* object 

setltem 

IMenu 

Boolean inUse=tmQ 

IMenuItem& menultem 

setltemHandle 

IBaseListBox 

unsigned long index 


IB aseComboB ox 

unsigned long handle 
unsigned long index 

setltemHeight 

IBaseListBox 

unsigned long handle 
unsigned long newHeight 

setltemText 

IB aseComboB ox 

unsigned long index 


IBaseListBox 

char* string 

Boolean update Entry Field= false 
unsigned long index 

setLayoutDistorted 

I Window 

IResourceId& string 
unsigned long layoutAttributesOn 

setMajorTabSize 

INotebook 

unsigned long layoutAttributesOjf 

ISize& sizeMajorTab 

setMaster 

IBaseSpinButton 

IBaseSpinButton& master 

setMenu 

IMenuBar 

IResourceId& menuResId 

setMinorTabSize 

INotebook 

ISize& sizeMinorTab 

setMixedT argetEmphasis 

IContainerControl 


setMonitorWindow 

IMMDigital V ideo 

IWindow& window 

setMultipleSelection 

IContainerControl 

CallType call= IMMDe vice "wait 

setN ormalT argetEmphasis 

IContainerControl 


setOKB uttonT ext 

IVBFileDialog 

IResourceId& resld 

setOpenDialog 

IVBFileDialog 
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Action 

Class name 

Parameters 

setOrderedT argetEmphasis 

IContainerControl 


setPageButtonSize 

INotebook 

ISize& sizePageButton 

setPosition 

IVBFileDialog 

IPoint& position 


IVBFontDialog 

IPoint& position 

setPreviewText 

IVBFontDialog 

char* previewText 

setPrinterPS 

IVBFontDialog 

IPresSpaceHandle& presSpaceHandle 

setPriority 

IApplication 

PriorityClass priorityClass 
long priorityLevel=0 

Boolean setDescendents=fa\se 

setProgram 

IMMAudioCD 

IMMAudioCDContents& program 

setRefreshOff 

IContainerObject 

IContainerControl 


setRowHeight 

IMultiCellCanvas 

unsigned long row 
unsigned long heightlnPixels 

Boolean expandable=fd\sz 

setS ave AsDialog 

IVBFileDialog 


setScrollBar 

IScrollBar 

IRange& scrollableRange 
unsigned long visibleCount 

setSelected 

IContainerControl 

IContainerObject* object 

Boolean select= true 

setSeparator 

IMenuItem 


setShaftBreadth 

IProgressIndicator 

unsigned long breadth 

setSingleSelection 

IContainerControl 


setSizeList 

IVBFontDialog 

char* sizeList 

setSplitBarThickness 

ISplitCanvas 

SplitBarArea area 
unsigned long thickness 

setSplitWindowPercentage 

ISplitCanvas 

IWindow* window 
unsigned long percentage 

setStatusText 

INotebook 

IPageHandle& referencePage 

IResourceId& resourceld 

setSubmenu 

IMenu 

unsigned long itemld 

IResourceId& submenuResId 

setTab 

IMultiLineEdit 

unsigned long tabPixellnterval 

setTabBitmap 

INotebook 

IPageHandle& referencePage 

IResourceId& resourceld 

setTabText 

INotebook 

IPageHandle& referencePage 
char* tabText 

setText 

IMenu 

unsigned long menultemld 

IResourceId& newTextResId 

setTickLength 

IProgressIndicator 

unsigned long tickNumber 
unsigned long length 

setTicks 

IProgressIndicator 

unsigned long scaleINumberOflicks 
unsigned long scale2NumberOfTicks 
unsigned long scalelTickSpacing= 0 
unsigned long scale2TickSpacing=0 

setTickText 

IProgressIndicator 

unsigned long tickNumber 
char* text 

setTimeToOrdinal 

IMMTime 

unsigned long ordinal 

setTitle 

IVBFontDialog 

char* title 


IHelpWindow 

char* titleText 


IVBFileDialog 

char* newTitle 
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Action 

Class name 

Parameters 


IMessageBox 

IResourceId& title 

setT itle Alignment 

IContainerControl 

TitleAlignment 

alignment=lContainerContro\: : centered 

setTitleText 

ITitle 

char* objectName 
char* viewName=0 
unsigned long viewNum= 0 

setTrackTitle 

IMMAudioCD 

IString& title 
unsigned long track 

setT reeExpandlconS ize 

IContainerControl 

ISize& sizelcon 

setTreeltemlcons 

IContainerControl 

IResourceId& expanded 

IResourceId& collapsed 

setT ree V ie wlndent 

IContainerControl 

long indentPixels=- 1 

setUserData 

INotebook 

IPageHandle& referencePage 
unsigned long userData 

setUsingHelp 

IHelpWindow 

unsigned long panelld 

setWindow 

INotebook 

IPageHandle& referencePage 

IWindow* pageWindow- 0 


IMMDigitalVideo 

IWindowHandle& handle 

CallType c<?//=IMMDe vice:: wait 

setWindowFont 

IFont 

IWindow* window 

shareParentDBCS Status 

IFrame Window 


show 

I Window 

Boolean visible= true 


IMessageBox 

IResourceId& message 

Style& style 
unsigned long helpld=0 


IVBFileDialog 

IWindow* parent 

IFileDialog::Style .s/y/e=IFileDialog::defaultStyle 
( ) 

IHandler* handler= 0 


IVBFontDialog 

IWindow* parent 

IFontDialog::Style 
sJy/e=IFontDialog::defaultstyle ( ) 

IHandler* handler= 0 

showDetails V iew 

IContainerControl 


showErrorlnfo 

IMessageBox 

IResourceId& message 

Style& style 
unsigned long helpld= 0 

showException 

IMessageBox 

IResourceId& message 

Style& style 
unsigned long helpld= 0 

showFlo wedN ame V iew 

IContainerControl 


showFlo wedT ext V iew 

IContainerControl 


showFromFont 

IVBFontDialog 

IFont* target 

IWindow* parent 

IFontDialog::Style 

5ty/^=IFontDialog:: defaults tyle ( ) 

IHandler* handler= 0 

showIconView 

IContainerControl 


showList 

IB aseComboB ox 

Boolean show= true 

showMinilcons 

IContainerControl 

Boolean mm/=true 

showModally 

IVBFontDialog 

IWindow* parent=N\JLL 
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Action 

Class name 

Parameters 


IVBFileDialog 

IFontDialog:: Style 

5 , /y/^=IFontDialog:: defaultstyle ( ) 

IHandler* handler= 0 

IWindow* parent= NULL 

sho wN ame V ie w 

IFrameWindow 

IContainerControl 

IFileDialog:: Style style= IFileDialog::defaultstyle 
() 

IHandler* handler= 0 

showObject 

IContainerControl 

IContainerObject* object 

showPanellds 

IHelpWindow 

Boolean visible=tme 

Boolean visibleld= true 

showSeparators 

IContainerColumn 

DataStyle& separatorStyles- horizontalSeparator 1 

showSourceEmphasis 

IWindow 

verticalSeparator 

Boolean show= true 

showSplitBar 

IContainerControl 

Boolean showSplitBar= true 

sho wText View 

IContainerControl 


showTreelconView 

IContainerControl 


showTreeLine 

IContainerControl 

long tree Line PixelWidth=- 1 

sho wTreeN ame V ie w 

IContainerControl 


sho wT reeT ext V ie w 

IContainerControl 


shrinkBy 

IRectangle 

IPair& pair 

shrunkBy 

IRectangle 

IPair& pair 

sizeBy 

IRectangle 

Coord factor 

sizedBy 

IRectangle 

double factor 

sizedTo 

IRectangle 

IPair& pair 

sleep 

ICurrentThread 

unsigned long milliseconds 

sort 

IRSequence 

long ( * comparisonFunction ) ( Element const & 

sortBylconText 

IContainerControl 

, Element const & ) 

Boolean ascending= true 

space 

IString 

unsigned numSpaces- 1 

spinDown 

IBaseSpinButton 

char spaceChar= ' 
unsigned long spinBy=\ 

spinTo 

ITextSpinButton 

unsigned long index 


IN umericS pinB utton 

long aValue 

spinUp 

IBaseSpinButton 

Boolean spinToClosest=fa\sQ 
unsigned long spinBy= 1 

splitBarThickness 

ISplitCanvas 

SplitBarArea area 

splitWindowPercentage 

ISplitCanvas 

IWindow* window 

start 

IlnfoArea 

IFrameWindow* frame 


IFrameWindow 

IWindowHandle& hwnd 


IHandler 

IWindow* window 

startAnimation 

IAnimatedButton 

unsigned long index= 0 

startPositionTracking 

IMMPlayableDevice 

IMMTime& timelnterval 

startScanningBackward 

IMMAudioCD 

CallType ca//=IMMDevice::wait 

startScanningForward 

IMMAudioCD 


stepFrame 

IMMPlayableDevice 

unsigned long frames=\ 

stop 

IMMPlayableDevice 

Boolean forward^ true 

CallType ca//=IMMDevice::wait 

CallType ca//=IMMDevice::wait 
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Figure 252 (Page 24 of 26). Actions 


Action 

Class name 

Parameters 


IlnfoArea 

IFrame Window* frame 


IHandler 

IWindow* window 

stopAnimation 

IAnimatedButton 


stopHandlingNotificationsFor 

IObserver 

INotifier& notifier 

stopPositionTracking 

IMMPlayableDevice 

CallType ctf//=IMMDe vice "wait 

strip 

IString 

IString& aString 
char aChar 

stripBlanks 

IString 

IString& aString 

stripLeading 

IString 

IString& aString 
char* pStringOfChars 

stripLeadingBlanks 

IString 

IString& aString 

stripTrailing 

IString 

IString& aString 

IStringTest& aTest 

stripTrailingBlanks 

IString 

IString& aString 

substring 

IString 

unsigned startPos 

supportsCommand 

IMMDevice 

IMMNotifyEvent::Command command 

CallType ca//=IMMDevice::wait 

supports W aveFormat 

IMMW ave Audio 

unsigned long bitsPerSample 
unsigned long samplesPerSecond 
unsigned long channels 

IMMAudioBuffer: :Format format 

CallType call= IMMDevice: :wait 

terminateGUI 

ICurrentThread 


textLines 

IFont 

char* text 

unsigned long lineWidth 

textRectangle 

IC ontainerControl 

IContainerObject* object 

textWidth 

IFont 

char* text 

throwCLibError 

ICLibErrorlnfo 

char* functionName 

IExceptionLocation& location 

IErrorlnfo::ExceptionType n«m^=accessError 
IException:: Severity severity recoverable 

throwError 

IErrorlnfo 

IExceptionLocation& location 

IErrorlnfo: :ExceptionType name= accessError 
IException::Severity severity=recovemb\e 
IException::Severity severity=recoverab\e 

throwGUIError 

IGUIErrorlnfo 

char* functionName 

IExceptionLocation& location 

IErrorlnfo::ExceptionType name= accessError 
IException::Severity severi /y=recoverab 1 e 

throwMMError 

IMMErrorlnfo 

unsigned long errorld 
char* functionName 

IExceptionLocation& location 

IErrorlnfo::ExceptionType name= accessError 
IException::Severity severity=recoverab\e 

throwSystemError 

ISystemErrorlnfo 

unsigned long systemErrorld 
char* functionName 

IExceptionLocation& location 

IErrorlnfo::ExceptionType name= accessError 
IException::Severity severity^ recoverable 

tickLength 

IProgressIndicator 

unsigned long tickNumber 

tickPosition 

IProgressIndicator 

unsigned long tickNumber 
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Action 

Class name 

Parameters 

tickSpacing 

IProgressIndicator 

Scale scale 

tickText 

IProgressIndicator 

unsigned long tickNumber 

trackBackward 

IMMAudioCD 

unsigned long decrements 1 

trackForward 

IMMAudioCD 

unsigned long increment= 1 

trackTitle 

IMMAudioCD 

unsigned long track 

translate 

IString 

IString& inputChars 

IString& outputChars 
char padCharacter= ' 

transpose 

IPair 


tryToLoadBitmap 

IResourceLibrary 

unsigned long bitmapld 

ISize& bitmapSize 

Boolean cached=\me 

tryToLoadlcon 

IResourceLibrary 

unsigned long iconld 

Boolean cached= true 

tryToLoadMessage 

IResourceLibrary 

unsigned long messageld 

tryToLoadString 

IResourceLibrary 

unsigned long stringld 

turnToPage 

INotebook 

Cursor& cursor 

uncheckltem 

IMenu 

unsigned long itemld 

undo 

IMMRecordable 

ISubmenu 

IMultiLineEdit 

CallType ca//=IMMDevice::wait 

unhighlight 

IButton 


unlatch 

ICustomButton 


unlock 

IResource 


unlockDoor 

IMMRemovableMedia 

CallType ctf//=IMMDevice::wait 

unset 

IAccelerator 


update 

IFrame Window 


uppercase 

IString 

IString& aString 

useBitmapOnly 

IFont 

Boolean bitmapOnly=tmQ 

IPresSpaceHandle& 

presSpaceHandle= IPresSpaceHandle ( ) 

useDefaultMonitorWindow 

IMMDigitalVideo 

CallType c«//=IMMDevice::wait 

useDefaultWindow 

IMMDigitalVideo 

CallType ca//=IMMDevice::wait 

useExtensionMinimumSize 

IFrame Window 

Window* extension 

useN onPropOnly 

IFont 

Boolean nonProportionalOnly= true 
IPresSpaceHandle& 

presSpaceHandle=lPresSpaceHand\e ( ) 

useVectorOnly 

IFont 

Boolean vectorOnly= true 

IPresSpaceHandle& 

presSpaceHandle=lPresSpaceHand\Q ( ) 

waitFor 

ICurrentThread 

IThread& anotherThread 

waitForAllThreads 

ICurrentThread 


window 

INotebook 

IPageHandle& page 

windowInCell 

IMultiCellCanvas 

unsigned long startingColumn 
unsigned long startingRow 

word 

IString 

unsigned wordNumber 

wordlndexOfPhrase 

IString 

IString& aPhrase 
unsigned startWord— 1 

words 

IString 

unsigned firstWord 
unsigned numWords 

write 

ITrace 

char* text 
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Figure 252 (Page 26 of 26). Actions 


Action 

Class name 

Parameters 

writeToQueue 

ITrace 


writeToStandardError 

ITrace 


writeToStandardOutput 

ITrace 


x2b 

IString 


x2c 

IString 

IString& aString 

x2d 

IString 

IString& aString 
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Figure 253 (Page 1 of 2). Events 


Event 

Class name 

Notification ID 

activateEvent 

IFrameWindow 

activateld 

addedEvent 

IRSequence 

addedld 

addEvent 

IContainerControl 

addld 

buttonClickEvent 

IButton 

buttonClickld 

characterTypeEvent 

IEntryField 

characterT y peld 

closeEvent 

IFrameWindow 

closeld 

commandEvent 

IWindow 

commandld 


IMenuItem 

commandld 

commandNotifyEvent 

IMMDevice 

commandNotifyld 

createdEvent 

IVBFontDialog 

createdld 


IVBFileDialog 

createdld 

cuePointEvent 

IMMDevice 

cuePointld 

deactivateEvent 

IFrameWindow 

deactivateld 

detail s V ie wT itlesEvent 

IContainerControl 

details V ie wT itlesld 

deviceEvent 

IMMDevice 

deviceEventld 

dismissedEvent 

IVBFontDialog 

dismissedld 


IVBFileDialog 

dismissedld 

enterEvent 

IBaseListBox 

enterld 


IBaseComboBox 

enterld 


IBaseListBox 

enterld 


IContainerControl 

enterld 


IBaseComboBox 

enterld 

extendedSelectChangedEvent 

ICollectionViewListBox 

extendedSelectChangedld 

gotFocusEvent 

IWindow 

FOCUSTRUEID 

inputDisabledEvent 

IWindow 

ENABLEFALSEID 

inputEnabledEvent 

IWindow 

EN AB LETRUEID 

itemChangedEvent 

ICollectionViewComboBox 

itemChangedld 


ICollectionViewListBox 

itemChangedld 

lostFocusEvent 

IWindow 

FOCUSFALSEID 

mediaLoadedEvent 

IMMRemovableMedia 

mediaLoadedld 

modifiedEvent 

IRSequence 

modifiedld 

newEvent 

IVB Factory 

ne wObj ectCreateld 

passDeviceEvent 

IMMDevice 

passDeviceld 

positionChangeEvent 

IMMDevice 

positionChangeld 

positionTimerEvent 

IMMAudioCD 

positionTimerld 

pressedOkEvent 

IVBFontDialog 

pressedOkld 


IVBFileDialog 

pressedOkld 

removedEvent 

IRSequence 

removedld 

removeEvent 

IContainerControl 

removeld 

replacedEvent 

IRSequence 

replacedld 

scaleEvent 

IProgressIndicator 

scaleld 

selectEvent 

IContainerControl 

selectld 

selectionDefaultActionEvent 

I VB ContainerControl 

selectionDefaultActionld 

selectionlndexChangedEvent 

I VB ContainerControl 

selectionlndexChangedld 

systemCommandEvent 

IWindow 

systemCommandld 

textEvent 

IBaseSpinButton 

textld 

tracks tartedE vent 

IMMAudioCD 

tracks tartedld 

valueEvent 

IBaseSpinButton 

valueld 
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Figure 253 (Page 2 of 2). Events 

Event Class name Notification ID 


visibilityDisabledEvent IWindow 

visibilityEnabledEvent IWindow 


VISIBLEFALSEID 

VISIBLETRUEID 
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abstract class ‘class 


Glossary 


This glossary defines terms and abbreviations that are used in 
this book. If you do not find the term you are looking for, 
refer to the IBM Dictionary of Computing, New 
York:McGraw-Hill, 1994. 

This glossary includes terms and definitions from the 
American National Standard Dictionary for Information 
Systems, ANSI X3.172-1990, copyright 1990 by the 
American National Standards Institute (ANSI). Copies may 
be purchased from the American National Standards Institute, 
1430 Broadway, New York, New York 10018. 


A 

abstract class. A class that provides common behavior 
across a set of subclasses but is not itself designed to have 
instances that work. An abstract class represents a concept; 
classes derived from it represent implementations of the 
concept. For example, IControl is the abstract base class for 
control view windows; the ICanvas and IListBox classes are 
controls derived from IControl. An abstract class must have 
at least one pure virtual function. 

See also base class. 

access. A property of a class that determines whether a class 
member is accessible in an expression or declaration. 

action. A specification of a function that a part can perform. 
The visual builder uses action specifications to generate 
connections between parts. Actions are resolved to member 
function calls in the generated code. 

Compare to event and attribute. 

argument. A data element, or value, included as part of a 
member function call. Arguments provide additional 
information that the called member function can use to 
perform the requested operation. 

attribute. A specification of a property of a part. For 
example, a customer part could have a name attribute and an 
address attribute. An attribute can itself be a part with its 
own behavior and attributes. 

The visual builder uses attribute specifications to generate 
code to get and set part properties. 

Compare to event and action. 


attribute-to-action connection. A connection that starts an 
action whenever an attribute’s value changes. It is similar to 
an event-to-action connection because the attribute’s event ID 
is used to notify the action when the value of the attribute 
changes. 

See also connection. Compare to event-to-action connection. 

attribute-to-attribute connection. A connection from an 
attribute of one part to an attribute of another part. When 
one attribute is updated, the other attribute is updated 
automatically. 

See also connection. 

attribute-to-member function connection. A connection 
from an attribute of a part to a member function. The 
connected attribute receives its value from the member 
function, which can make calculations based on the values of 
other parts. 

See also connection. 

B 

base class. A class from which other classes or parts are 
derived. A base class may itself be derived from another 
base class. 

See also abstract class. 

behavior. The set of external characteristics that an object 
exhibits. 

C 

caller. An object that sends a member function call to 
another object. 

Contrast with receiver. 

category. In the Composition Editor, a selectable grouping 
of parts represented by an icon in the left-most column. 
Selecting a category displays the parts belonging to that 
category in the next column. 

See also parts palette. 

class. An aggregate that can contain functions, types, and 
user-defined operators, in addition to data. Classes can be 
defined hierarchically, allowing one class to be an expansion 
of another, and can restrict access to its members. 
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Class Editor •derivation 


Class Editor. The editor you use to specify the names of 
files that Visual Builder writes to when you generate default 
code. You can also use this editor to do the following: 

• Enter a description of the part 

• Specify a different .vbb file in which to store the part 

• See the name of the part’s base class 

• Modify the part’s default constructor 

• Enter additional constructor and destructor code 

• Specify a .lib file for the part 

• Specify a resource DLL and ID to assign an icon to the 
part 

• Specify other files that you want to include when you 
build your application 

Compare to Composition Editor and Part Interface Editor. 

class hierarchy. A tree-like structure showing relationships 
among object classes. It places one abstract class at the top 
(a base class) and one or more layers of less abstract classes 
below it. 

class library. A collection of classes. 

class member function. See member function. 

client area object. An intermediate window between a 
frame window (IFrameWindow) and its controls and other 
child windows. 

client object. An object that requests services from other 
objects. 

collection. A set of features in which each feature is an 
object. 

Common User Access (CUA). An IBM architecture for 
designing graphical user interfaces using a set of standard 
components and terminology. 

composite part. A part that is composed of a part and one 
or more subparts. A composite part can contain visual parts, 
non visual parts, or both. 

See also nonvisual part, part, subpart, and visual part. 

Composition Editor. A view that is used to build a 
graphical user interface and to make connections between 
parts. 

Compare to Class Editor and Part Interface Editor. 

concrete class. A subclass of an abstract class that is a 
specialization of the abstract class. 

connection. A formal, explicit relationship between parts. 
Making connections is the basic technique for building any 


visual application because that defines the way in which parts 
communicate with one another. The visual builder generates 
the code that then implements these connections. 

See also attribute-to-action connection, attribute-to-attribute 
connection, attribute-to-member function connection, 
parameter connection, custom logic connection, 
event-to-action connection, event-to-attribute connection, and 
event-to-member function connection. 

const. An attribute of a data object that declares that the 
object cannot be changed. 

construction from parts. A software development 
technology in which applications are assembled from existing 
and reusable software components, known as parts. 

constructor. A special class member function that has the 
same name as the class and is used to construct and possibly 
initialize class objects. 

CUA. See Common User Access. 

cursored emphasis. When the selection cursor is on a 
choice, that choice has cursored emphasis. 

custom logic connection. A connection that causes your 
customized C or C++ code to be run. This connection can be 
triggered either when an attribute’s value changes or an event 
occurs. 

D 

data abstraction. A data type with a private representation 
and a public set of operations. The C++ language uses the 
concept of classes to implement data abstraction. 

data member. Private data that belongs to a given object 
and is hidden from direct access by all other objects. Data 
members can only be accessed by the member functions of 
the defining class and its subclasses. 

data model. A combination of the base classes and parts 
shipped with the product and the classes and parts you save 
and create. They are saved in a file named vbbase.vbb. 

data object. A storage area used to hold a value. 

declaration. A description that makes an external object or 
function available to a function or a block. 

DEF file. See module definition file. 

derivation. The creation of a new or abstract class from an 
existing or base class. 
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destructor ‘loaded 


destructor. A special class member function that has the 
same name as the class and is used to destruct class objects. 

DLL. See dynamic link library. 

dynamic link library (DLL). In OS/2, a library containing 
data and code objects that can be used by programs or 
applications during loading or at run time. Although they are 
not part of the program’s executable (.exe) file, they are 
sometimes required for an .exe file to run properly. 

E 

encapsulation. The hiding of a software object’s internal 
representation. The object provides an interface that queries 
and manipulates the data without exposing its underlying 
structure. 

event. A specification of a notification from a part. 

Compare to action, attribute, and part event. 

event-to-action connection. A connection that causes an 
action to be performed when an event occurs. 

See also connection. 

event-to-attribute connection. A connection that changes 
the value of an attribute when a certain event occurs. 

See also connection. 

event-to-member function connection. A connection from 
an event of a part to a member function. When the 
connected event occurs, the member function is executed. 

See also connection. 

expansion area. The section of a multicell canvas between 
the current cell grid and the outer edge of the canvas. 
Visually, this area is bounded by the rightmost column 
gridline and the bottommost row gridline. 

F 

feature. (1) A major component of a software product that 
can be installed separately. (2) In Visual Builder, an action, 
attribute, or event that is available from a part’s part interface 
and that other parts can connect to. 

full attribute. An attribute that has all of the behaviors and 
characteristics that an attribute can have: a data member, a 
get member function, a set member function, and an event 
identifier. 


free-form surface. The large open area of the Composition 
Editor window. The free-form surface holds the visual parts 
contained in the views you build and representations of the 
nonvisual parts (models) that your application includes. 

G 

graphical user interface (GUI). A type of interface that 
enables users to communicate with a program by 
manipulating graphical features, rather than by entering 
commands. Typically, a graphical user interface includes a 
combination of graphics, pointing devices, menu bars and 
other menus, overlapping windows, and icons. 

GUI. See graphical user interface. 

H 

handles. Small squares that appear on the comers of a 
selected visual part in the visual builder. Handles are used to 
resize parts. 

Compare to primary selection. 

header file. A file that contains system-defined control 
information that precedes user data. 

I 

inheritance. (1) A mechanism by which an object class can 
use the attributes, relationships, and member functions 
defined in more abstract classes related to it (its base classes). 
(2) An object-oriented programming technique that allows 
you to use existing classes as bases for creating other classes. 

instance. Synonym for object, a particular instantiation of a 
data type. 

L 

legacy code. Existing code that a user might have. Legacy 
applications often have character-based, nongraphical user 
interfaces; usually they are written in a nonobject-oriented 
language, such as C or COBOL. 

loaded. The state of the mouse pointer between the time 
you select a part from the parts palette and deposit the part 
on the free-form surface. 
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M 

main part. The part that users see when they start an 
application. This is the part from which the main() function 
C++ code for the application is generated. 

The main part is a special kind of composite part. 

See also part and subpart. 

member. (1) A data object in a structure or a union. (2) In 
C++, classes and structures can also contain functions and 
types as members. 

member function. An operator or function that is declared 
as a member of a class. A member function has access to the 
private and protected data members and member functions of 
objects of its class. 

member function call. A communication from one object to 
another that requests the receiving object to execute a 
member function. 

A member function call consists of a member function name 
that indicates the requested member function and the 
arguments to be used in executing the member function. The 
member function call always returns some object to the 
requesting object as the result of performing the member 
function. 

Synonym for message. 

member function name. The component of a member 
function call that specifies the requested operation. 

message. A request from one object that the receiving object 
implement a member function. Because data is encapsulated 
and not directly accessible, a message is the only way to send 
data from one object to another. Each message specifies the 
name of the receiving object, the member function to be 
implemented, and any arguments the member function needs 
for implementation. 

Synonym for member function call. 

model. A nonvisual part that represents the state and 
behavior of a object, such as a customer or an account. 

Contrast with view. 

module definition file. A file that describes the code 
segments within a load module. 

Synonym for DEF file. 


N 

nested class. A class defined within the scope of another 
class. 

nonvisual part. A part that has no visual representation at 
run time. A nonvisual part typically represents some 
real-world object that exists in the business environment. 

Compare to model. Contrast with view and visual part. 

no-event attribute. An attribute that does not have an event 
identifier. 

no-set attribute. An attribute that does not have a set 
member function. 

notebook part. A visual part that resembles a bound 
notebook containing pages separated into sections by tabbed 
divider pages. A user can turn the pages of a notebook or 
select the tabs to move from one section to another. 

O 

object. (1) A computer representation of something that a 
user can work with to perform a task. An object can appear 
as text or an icon. (2) A collection of data and member 
functions that operate on that data, which together represent a 
logical entity in the system. In object-oriented programming, 
objects are grouped into classes that share common data 
definitions and member functions. Each object in the class is 
said to be an instance of the class. (3) An instance of an 
object class consisting of attributes, a data structure, and 
operational member functions. It can represent a person, 
place, thing, event, or concept. Each instance has the same 
properties, attributes, and member functions as other instances 
of the object class, though it has unique values assigned to its 
attributes. 

object class. A template for defining the attributes and 
member functions of an object. An object class can contain 
other object classes. An individual representation of an 
object class is called an object. 

object factory. A nonvisual part capable of dynamically 
creating new instances of a specified part. For example, 
during the execution of an application, an object factory can 
create instances of a new class to collect the data being 
generated. 

object-oriented programming. A programming approach 
based on the concepts of data abstraction and inheritance. 
Unlike procedural programming techniques, object-oriented 
programming concentrates on those data objects that comprise 


646 Visual Builder Parts Reference 



observer »pure virtual function 


the problem and how they are manipulated, not on how 
something is accomplished. 

observer. An object that receives notification from a notifier 
object. 

operation. A member function or service that can be 
requested of an object. 

overloading. An object-oriented programming technique that 
allows you to redefine functions and most standard C++ 
operators when the functions and operators are used with 
class types. 

P 

palette. See parts palette. 

parameter connection. A connection that satisfies a 
parameter of an action or member function by supplying 
either an attribute’s value or the return value of an action, 
member function, or custom logic. The parameter is always 
the source of the connection. 

See also connection. 

parent class. The class from which another part or class 
inherits data, member functions, or both. 

part. A self-contained software object with a standardized 
public interface, consisting of a set of external features that 
allow the part to interact with other parts. A part is 
implemented as a class that supports the INotifier protocol 
and has a part interface defined. 

The parts on the palette can be used as templates to create 
instances or objects. 

part event. A representation of a change that occurs to a 
part. The events on a part's interface enable other interested 
parts to receive notification when something about the part 
changes. For example, a push button generates an event 
signaling that it has been clicked, which might cause another 
part to display a window. 

part event ID. The name of a part static-data member used 
to identify which notification is being signaled. 

part interface. A set of external features that allows a part 
to interact with other parts. A part’s interface is made up of 
three characteristics: attributes, actions, and events. 

Part Interface Editor. An editor that the application 
developer uses to create and modify attributes, actions, and 
events, which together make up the interface of a part. 


Compare to Class Editor and Composition Editor. 

parts palette. The parts palette holds a collection of visual 
and nonvisual parts used in building additional parts for an 
application. The parts palette is organized into categories. 
Application developers can add parts to the palette for use in 
defining applications or other parts. 

preferred features. A subset of the part’s features that 
appear in a pop-up connection menu. Generally, they are the 
features used most often. 

primary selection. In the Composition Editor, the part used 
as a base for an action that affects several parts. For 
example, an alignment tool will align all selected parts with 
the primary selection. Primary selection is indicated by 
closed (solid) selection handles, while the other selected parts 
have open selection handles. 

See also selection handles. 

private. Pertaining to a class member that is accessible only 
to member functions and friends of that class. 

process. A program running under OS/2, along with the 
resources associated with it (memory, threads, file system 
resources, and so on). 

program. (1) One or more files containing a set of 
instructions conforming to a particular programming language 
syntax. (2) A self-contained, executable module. Multiple 
copies of the same program can be run in different processes. 

protected. Pertaining to a class member that is only 
accessible to member functions and friends of that class, or to 
member functions and friends of classes derived from that 
class. 

prototype. A function declaration or definition that includes 
both the return type of the function and the types of its 
arguments. 

primitive part. A basic building block of other parts. A 
primitive part can be relatively complex in terms of the 
function it provides. 

process. A collection of code, data, and other system 
resources, including at least one thread of execution, that 
performs a data processing task. 

property. A unique characteristic of a part. 

pure virtual function. A virtual function that has a function 
definition of = 0;. 
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R 

receiver. The object that receives a member function call. 
Contrast with caller. 

resource file. A file that contains data used by an 
application, such as text strings and icons. 

S 

selection handles. In the Composition Editor, small squares 
that appear on the corners of a selected visual part. Selection 
handles are used to resize parts. 

See also primary selection. 

server. A computer that provides services to multiple users 
or workstations in a network; for example, a file server, a 
print server, or a mail server. 

service. A specific behavior that an object is responsible for 
exhibiting. 

settings view. A view of a part that provides a way to 
display and set the attributes and options associated with the 
part. 

sticky. In the Composition Editor, the mode that enables 
you to add multiple parts of the same class (for example, 
three push buttons) without going back and forth between the 
parts palette and the free-form surface. 

structure. A construct that contains an ordered group of 
data objects. Unlike an array, the data objects within a 
structure can have varied data types. 

subpart. A part that is used to create another part. 

See also nonvisual part, part, and visual part. 

superclass. See abstract class and base class. 

T 

tear-off attribute. An attribute that an application developer 
has exposed to work with as though it were a stand-alone 
part. 

template. A family of classes or functions with variable 
types. 

thread. A unit of execution within a process. 


tool bar. The strip of icons along the top of the free-form 
surface. The tool bar contains tools to help you construct 
composite parts. 

U 

UI. See user interface. 

unloaded. The state of the mouse pointer before you select 
a part from the parts palette and after you deposit a part on 
the free-form surface. In addition, you can unload the mouse 
pointer by pressing the Esc key. 

user interface (UI). (1) The hardware, software, or both 
that enable a user to interact with a computer. (2) The term 
user interface normally refers to the visual presentation and 
its underlying software with which a user interacts. 

V 

variable. (1) A storage place within an object for a data 
feature. The data feature is an object, such as number or 
date, stored as an attribute of the containing object. (2) A 
part that receives an identity at run time. A variable by itself 
contains no data or program logic; it must be connected such 
that it receives runtime identity from a part elsewhere in the 
application. 

view. (1) A visual part, such as a window, push button, or 
entry field. (2) A visual representation that can display and 
change the underlying model objects of an application. 

Views are both the end result of developing an application 
and the basic unit of composition of user interfaces. 

Compare to visual part. Contrast with model. 

virtual function. A function of a class that is declared with 
the keyword virtual. The implementation that is executed 
when you make a call to a virtual function depends on the 
type of the object for which it is called. This is determined 
at run time. 

visual part. A part that has a visual representation at run 
time. Visual parts, such as windows, push buttons, and entry 
fields, make up the user interface of an application. 

Compare to view. Contrast with nonvisual part. 

visual programming tool. A tool that provides a means for 
specifying programs graphically. Application programmers 
write applications by manipulating graphical representations 
of components. 
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white space ‘window 


w 

white space. Space characters, tab characters, form-feed 
characters, and new-line characters. 


window being on top of another. (2) In the Composition 
Editor, a window is a part that can be used as a container for 
other visual parts, such as push buttons. 


window. (1) A rectangular area of the screen with visible 
boundaries in which information is displayed. Windows can 
overlap on the screen, giving it the appearance of one 


Glossary 
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